Get started
Get started with blocks.md and start creating amazing forms and web pages using Markdown.
1. Get a license
blocks.md is licensed under BUSL-1.1, which means that it is free to use as long as it is on local. Once you're ready to use the software in production, you'll first need to get a license from our website.
There are three types of licenses available depending on what you need:
Standard license: one website/end-product
Multisite license: unlimited websites/end-products
Enterprise license: for integration into products
Once you've purchased a license (or you're on local), you can proceed to the next step.
2. Install via npm
npm
3. Convert Markdown files to forms and pages
Once you've installed blocks.md, put all of your Markdown files in a src
directory. You can also have your images and media files in src/static
(that is, within the input directory), and this directory will be copied for you. Once you're ready, run the following command in your CLI:
By default, this command will look for a directory called src
and place the resulting output in a new site
directory. It will also create the necessary CSS and JS files in a new site/blocksmd
directory (that is, within the output directory) and copy the static files. However, you can specify the input and output directories, and also set the name of the static directory using the following options:
So for example, if you wanted to convert the Markdown files in the cms/pages
directory and place the output in website
, you would run the following:
The output folder is a static site with regular HTML files, and you can host them on Github Pages, Netlify, Vercel, etc. For example, you can literally drag and drop an output folder created using blocks.md to Netlify Drop, and your forms and pages will all work properly.
Watch video
Next steps
You can find a more in-depth usage guide here:
How to useLast updated