Skip to article content


Blocks provide a structural division of MyST documents using +++. These correspond, for example, to separate cells in a Jupyter Notebook. There can be optional metadata associated with the block, such as “tags”, “parts” or other identifiers.


You may add comments by putting the % character at the beginning of a line. This will prevent the line from being shown in the output document.

Comments split paragraphs

Putting a comment between items will split any preceding elements. For example, a comment between two lines of text will be broken up into two paragraphs, resulting in a margin between them:

MyST MarkdownMyST Markdown
Community-driven tools for the future of technical communication and publication