With the Markdown block, you can create formatted content using only regular characters and some punctuation marks. Markdown is used by writers and bloggers who want a quick and easy way to write formatted text, but without having to take their hands off the keyboard, and without learning a lot of complicated codes and shortcuts.
Note: this page describes how to use Markdown when using the Block Editor. You can find instructions on adding Markdown to the Classic editor here.
Requirements
The Markdown block is enabled by default when you set up Jetpack.
Since it is a block only, it remains available even if you disable the Markdown feature in Jetpack → Settings → Writing → Composing.
Adding a Markdown block
To add a Markdown Block to any post or page, follow these steps:
Go to your site’s WP Admin and open the post or page where you want to insert the Markdown block. Alternatively, create a new post or page.
Click the plus icon (+) located in the top-left corner or within the content editor area to open the block inserter.
In the block inserter’s search bar, type “markdown” and press Enter.
From the search results, click on the Jetpack Markdown block to add it to your post or page.
Once the block is inserted, you can start writing in Markdown format within the block.
See our Jetpack Blocks page for more information about adding Jetpack blocks.
Previewing Markdown Content
To ensure your Markdown content appears as intended, you can use the “Preview” option available on the block toolbar.
This allows you to see a real-time rendered version of your Markdown text, making it easy to verify formatting and make any necessary adjustments before publishing your post or page.
Selecting the preview option on the Markdown block toolbar
Learning Markdown
It’s easy to get started writing in Markdown! You can see the basics on this page. If you need a more detailed guide, there’s also a 10-minute tutorial.
Here’s a brief overview of some common Markdown elements:
Headers: Use # for headings. The number of # symbols indicates the heading level (e.g., # Heading 1, ## Heading 2, ### Heading 3).
Emphasis: Use * or _ to create italic text (e.g., *italic* or _italic_) and ** or __ for bold text (e.g., **bold** or __bold__).
Lists: Use *, -, or + for unordered lists and numbers followed by a period for ordered lists (e.g., 1. Item 1, 2. Item 2).
Links: Use [link text](URL) to create hyperlinks (e.g., [Jetpack](https://jetpack.com)).
Images: Use  to insert images (e.g., ).
Blockquotes: Use > before the text to create a blockquote (e.g., > This is a blockquote.).
Code: Use backticks (`) for inline code and triple backticks (```) for code blocks.
Horizontal rules: Use three or more -, *, or _ on a line by themselves to create a horizontal rule.
Adding Footnotes
The Jetpack Markdown block supports footnotes, allowing you to reference and annotate your content. To add footnotes to your Markdown text within the Jetpack Markdown block, follow this simple syntax:
Inline footnote reference: Add [^identifier] after the text that you want to reference. Replace identifier with a unique label for the footnote (e.g., 1, longnote, or any other label you prefer).
Footnote definition: At the end of your text, add a new line starting with [^identifier]: followed by a space and the footnote content. Remember to replace identifier with the unique label you used for the inline footnote reference.
Markdown text with inline and multiline footnotes in Jetpack Markdown block
Example:
Inline footnote reference: Jetpack is a powerful plugin for WordPress, providing numerous features and enhancements.[^1]
Footnote definition: [^1]: Learn more about Jetpack and its features at [the official Jetpack website](https://jetpack.com).
For multiline footnotes, indent any additional lines with four spaces or a tab.
Example:
Inline footnote reference: WordPress is an open-source content management system used by millions of websites around the world.[^longnote]
Multiline footnote definition:
[^longnote]: WordPress was first released in 2003.
Since then, it has grown to become one of the most popular website-building platforms, powering over 40% of the internet. Its vast ecosystem of plugins, themes, and community support make it a versatile and adaptable choice for many different types of websites. For more information, visit the [official WordPress website](https://wordpress.org).
This new feature enhances your writing experience, making it convenient to provide additional information or citations without disrupting the flow of your text. To verify that footnotes are working correctly, save your draft and view the changes on the frontend of your website.
Markdown Implementation
Our Markdown block uses the markdown-it parser, which supports the CommonMark spec. If you need full details of the syntax that our Markdown block supports, see the markdown-itdemo page.
Markdown Block
With the Markdown block, you can create formatted content using only regular characters and some punctuation marks. Markdown is used by writers and bloggers who want a quick and easy way to write formatted text, but without having to take their hands off the keyboard, and without learning a lot of complicated codes and shortcuts.
Note: this page describes how to use Markdown when using the Block Editor. You can find instructions on adding Markdown to the Classic editor here.
Requirements
The Markdown block is enabled by default when you set up Jetpack.
Since it is a block only, it remains available even if you disable the Markdown feature in Jetpack → Settings → Writing → Composing.
Adding a Markdown block
To add a Markdown Block to any post or page, follow these steps:
See our Jetpack Blocks page for more information about adding Jetpack blocks.
Previewing Markdown Content
To ensure your Markdown content appears as intended, you can use the “Preview” option available on the block toolbar.
This allows you to see a real-time rendered version of your Markdown text, making it easy to verify formatting and make any necessary adjustments before publishing your post or page.
Learning Markdown
It’s easy to get started writing in Markdown! You can see the basics on this page. If you need a more detailed guide, there’s also a 10-minute tutorial.
Here’s a brief overview of some common Markdown elements:
#
for headings. The number of#
symbols indicates the heading level (e.g.,# Heading 1
,## Heading 2
,### Heading 3
).*
or_
to create italic text (e.g.,*italic*
or_italic_
) and**
or__
for bold text (e.g.,**bold**
or__bold__
).*
,-
, or+
for unordered lists and numbers followed by a period for ordered lists (e.g.,1. Item 1
,2. Item 2
).[link text](URL)
to create hyperlinks (e.g.,[Jetpack](https://jetpack.com)
).
to insert images (e.g.,
).>
before the text to create a blockquote (e.g.,> This is a blockquote.
).`
) for inline code and triple backticks (```
) for code blocks.-
,*
, or_
on a line by themselves to create a horizontal rule.Adding Footnotes
The Jetpack Markdown block supports footnotes, allowing you to reference and annotate your content. To add footnotes to your Markdown text within the Jetpack Markdown block, follow this simple syntax:
[^identifier]
after the text that you want to reference. Replaceidentifier
with a unique label for the footnote (e.g.,1
,longnote
, or any other label you prefer).[^identifier]:
followed by a space and the footnote content. Remember to replaceidentifier
with the unique label you used for the inline footnote reference.Example:
Jetpack is a powerful plugin for WordPress, providing numerous features and enhancements.[^1]
[^1]: Learn more about Jetpack and its features at [the official Jetpack website](https://jetpack.com).
For multiline footnotes, indent any additional lines with four spaces or a tab.
Example:
WordPress is an open-source content management system used by millions of websites around the world.[^longnote]
This new feature enhances your writing experience, making it convenient to provide additional information or citations without disrupting the flow of your text. To verify that footnotes are working correctly, save your draft and view the changes on the frontend of your website.
Markdown Implementation
Our Markdown block uses the
markdown-it
parser, which supports the CommonMark spec. If you need full details of the syntax that our Markdown block supports, see themarkdown-it
demo page.Related