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.

Page Breaks

You may use block metadata to insert page breaks into your PDF or docx export with +++ { "page-break": true }. This will have no impact on your MyST site build nor other static exports that disregard “pages” (e.g. JATS).


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.

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