Blocks and comments


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.

+++ {"cell": "one"} cell 1 +++ {"meta": "data!"} cell 2


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.

This next line won't render, but it is in the HTML and LaTeX! % Markdown comment line

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:

a line % a comment another line