WordPress plugin

Learn how to use blocks.md in your WordPress sites.

Video guide

blocks.md - WordPress plugin

How to use

Follow the steps below to start using the plugin:

1. Install the plugin. You can buy it from our website and get it as a zip file. After that, just manually install the plugin in your WordPress site.
2. Select blocks.md template or blocks.md template RTL as the template for the page you want to use the plugin on. You can also create a new page.

3. Create a preformatted block that has a starting comment of <-- blocks.md -->.
4. After that, just write your Markdown in the preformatted block to create your forms and pages.

For example, here's a preformatted block that will be converted to a nice-looking subscription form if you place it in a WordPress page with the plugin installed and the correct template selected:

<!-- blocks.md -->

#! post-url = {post_url}

email* = EmailInput(
  | question = Join the newsletter
  | description = Subscribe with your email address for regular updates. We never spam, that's a promise.
)

Embed forms into your posts and pages

If you want to embed forms in your posts and pages, you can use a custom HTML block and then create an iframe within the block that links to the form URL. For example, let's say your form is within a WordPress page that has the URL https://my-site.wordpress.com/subscription-form. If you want to embed this form within another post or page, just place the following code inside of a custom HTML block:

<iframe
    src="https://my-site.wordpress.com/subscription-form"
    style="display: block; width: 500px; max-width: 100%; height: 350px; border: 0; margin-left: auto; margin-right: auto;">
</iframe>

Please remember to use your own URL as the src value. You may also need to change the width and the height to fit your needs better. On the form side, you may choose to hide the page progress and the footer on your form to make the embed look seamless:

<!-- blocks.md -->

#! page-progress = hide
#! footer = hide
#! post-url = {post_url}

email* = EmailInput(
  | question = Join the newsletter
  | description = Subscribe with your email address for regular updates. We never spam, that's a promise.
)

Update to latest version

If you've bought the WordPress plugin or a blocks.md software license, you can easily update to the latest version. Go to this page on our website and enter the email address that you used to buy the software. The page should automatically download the latest version of the WordPress plugin for you.

After that, just update the plugin manually in your WordPress admin site.

Can't find the blocks.md template for your pages?

If you don't see the option to change the page template to blocks.md template or blocks.md template RTL when creating/editing your pages, it probably means that the theme you're using is incompatible with the plugin. Some themes use full-site editing, which means custom page templates from plugins will not work with them.

If that is the case, consider using a theme that supports custom page templates (such as Astra), or a plugin like Multiple Themes to make sure you're using a compatible theme for the pages where you want blocks.md to work on.