Debian Codegraph @

org/testdata/footnotes.pretty_org

raw
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.