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.
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
You can add the Markdown block by searching and/or selecting it from the Jetpack section of the block selector:
See Jetpack Blocks for detailed instructions on adding 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.
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
_to create italic text (e.g.,
__for bold text (e.g.,
- Lists: Use
+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.,
- Images: Use
![Alt text](URL)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
_on a line by themselves to create a horizontal rule.
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
identifierwith a unique label for the footnote (e.g.,
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
identifierwith the unique label you used for the inline footnote reference.
- 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.
- 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.