This paragraph mentions a footnote[footnote](somenote).
[footnote=somenote]
----
This is the body of the footnote.
----Footnotes
How to create footnotes
To create a footnote in a Mau document you need to create a block with the argument footnote=NAME, where NAME is a unique string that identifies the footnote in the document.
The block contains the body of the footnote, that is the text of the note. You can then mention the footnote in any piece of processed text (paragraph, list, etc) using the macro footnote [footnote](NAME) and mentioning the name you chose before.
Mau source code
This paragraph mentions a footnote[1].
Showing footnotes
To render the list of all footnotes you use << footnotes that works just like << toc. It includes a node that contains a list of all footnotes that have been created in the document.
Mau source code
This paragraph mentions a footnote[footnote](somenote).
[footnote=somenote]
----
This is the body of the footnote.
----
<< footnotesMultiple footnote mentions
Once a footnote body has been created, it can be mentioned several times in different paragraphs. The mention can appear in the document before or after the body.
Mau source code
This paragraph mentions a footnote[footnote](somenote).
[footnote=somenote]
----
This is the body of the footnote.
----
This paragraph also mentions the footnote[footnote](somenote).
<< footnotesLabels and arguments
The list of footnotes supports arguments and labels. As for other types of include, arguments can be either inline or boxed, but never both.
Mau source code
[arg1, arg2]
.title Footnotes list with boxed arguments
<< footnotes
.title Footnotes list with inline arguments
<< footnotes: arg1, arg2Control conditions
The list of footnotes supports control conditions.
Mau source code
:var:42
@if var == 42
.title This list of footnotes will be rendered
<< footnotes
@if var == 43
.title This list of footnotes will NOT be rendered
<< footnotesBlock isolation
Footnotes included in blocks are not added to the document list of footnotes automatically, as blocks are isolated by default. To turn off isolation you can use the argument isolate
Mau source code
----
This paragraph mentions a footnote[footnote](somenote). The number of the footnote is valid only inside this block.
[footnote=somenote]
++++
This footnote is not visible in the document.
++++
----
This paragraph mentions another footnote[footnote](othernote).
[isolate=false]
----
[footnote=othernote]
++++
This footnote will be added to the list of footnotes.
++++
----
*The list of footnotes is rendered below*
<< footnotes