| 1 |
* Using some footnotes |
| 2 |
- normal footnote reference [fn:1] [fn:6] [fn:foo-bar] (footnote names can be anything in the format =[\w-]=) |
| 3 |
- further references to the same footnote should not [fn:1] render duplicates in the footnote list |
| 4 |
- inline footnotes are also supported via [fn:2:the inline footnote definition]. |
| 5 |
- anonymous inline footnotes are also supported via [fn::the anonymous inline footnote definition]. |
| 6 |
- Footnote definitions are not printed where they appear. |
| 7 |
Rather, they are gathered and exported at the end of the document in the footnote section. [fn:4] |
| 8 |
- footnotes that reference a non-existant definition are rendered but log a warning [fn:does-not-exist] |
| 9 |
|
| 10 |
[fn:4] so this definition will not be at the end of this section in the exported document. |
| 11 |
Rather, it will be somewhere down below in the footnotes section. |
| 12 |
|
| 13 |
[fn:5] this definition will also not be exported here - not only that, it will be overwritten by a definition |
| 14 |
of the same name later on in the document. That will log a warning but carry on nonetheless. |
| 15 |
* Footnotes |
| 16 |
Please note that the footnotes section is not automatically excluded from the export like in emacs. [fn:7] |
| 17 |
|
| 18 |
[fn:foo-bar] yolo |
| 19 |
|
| 20 |
[fn:1] https://www.example.com |
| 21 |
- footnotes can contain *markup* |
| 22 |
- and other elements |
| 23 |
- like blocks |
| 24 |
#+BEGIN_SRC |
| 25 |
other non-plain |
| 26 |
#+END_SRC |
| 27 |
- and tables |
| 28 |
| 1 | a | |
| 29 |
| 2 | b | |
| 30 |
| 3 | c | |
| 31 |
|
| 32 |
[fn:3] [[http://example.com/unused-footnote][example.com/unused-footnote]] |
| 33 |
|
| 34 |
[fn:5] another unused footnote (this definition overwrites the previous definition of =fn:5=) |
| 35 |
|
| 36 |
[fn:6] |
| 37 |
|
| 38 |
Footnotes break after two consecutive empty lines - just like paragraphs - see https://orgmode.org/worg/dev/org-syntax.html. |
| 39 |
This shouldn't happen when the definition line and the line after that are empty. |
| 40 |
|
| 41 |
|
| 42 |
[fn:7] |
| 43 |
There's multiple reasons for that. Among others, doing so requires i18n (to recognize the section) and silently |
| 44 |
hides content before and after the footnotes[fn:8]. |
| 45 |
|
| 46 |
|
| 47 |
|
| 48 |
this is not part of [fn:7] anymore as there are 2 blank lines in between! |
| 49 |
|
| 50 |
|
| 51 |
[fn:8] Footnotes can be linked from another footnote's definition. |