Notes let you attach additional content to a point in the main document flow without interrupting the main prose. Depending on the output format and note type, they may be rendered as footnotes, endnotes, or sidenotes.

In Stencila Markdown, notes are written using reference-style note markers and note definitions.

Use [^id] in the text to create a note reference, then define the note later in the document:

You can have multiple note references in the same paragraph:

Notes are not limited to a single line of text. They can contain multiple paragraphs and other block content.

Indent additional paragraphs so they remain part of the same note:

Notes can include code blocks:

Notes can also include quoted content:

The note syntax in Stencila Markdown is the same regardless of whether a note is eventually rendered as a footnote, endnote, or sidenote. The exact placement depends on the note type and the output format.

This means you can author notes once in Stencila Markdown and let Stencila handle how they are rendered in different publishing targets.

For related authoring features, see:

For the formal Stencila Schema definitions behind these features, see: