2.2 KiB
| template |
|---|
| overrides/main.html |
Footnotes
Footnotes are a great way to add references to supplemental or additional information to a specific word, phrase or sentence without interrupting the flow of a document. Material for MkDocs provides the ability to define and render footnotes.
Configuration
This configuration adds the ability to define footnotes inline with the content,
which are then rendered below all Markdown content of a document. Add the
following lines to mkdocs.yml:
markdown_extensions:
- footnotes
See additional configuration options:
Usage
Adding footnote references
A footnote reference must be enclosed in square brackets and must start with a
caret ^, directly followed by an arbitrary identifier, which is similar to
the standard Markdown link syntax.
Example:
Lorem ipsum[^1] dolor sit amet, consectetur adipiscing elit.[^2]
Result:
Lorem ipsum1 dolor sit amet, consectetur adipiscing elit.2
Adding footnote content
The footnote content must be declared with the same identifier as the reference. It can be inserted at an arbitrary position in the document and is always rendered at the bottom of the page. Furthermore, a backlink to the footnote reference is automatically added.
on a single line
Short footnotes can be written on the same line.
Example:
[^1]: Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Result:
Jump to footnote at the bottom of the page
on multiple lines
Paragraphs can be written on the next line and must be indented by four spaces.
Example:
[^2]:
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod
nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor
massa, nec semper lorem quam in massa.
Result: