Blocks¶
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).
Comments¶
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:
