This is the official manual for the latest Org-mode release.
Org mode supports the creation of footnotes. In contrast to the footnote.el package, Org mode's footnotes are designed for work on a larger document, not only for one-off documents like emails.
A footnote is started by a footnote marker in square brackets in column 0, no indentation allowed. It ends at the next footnote definition, headline, or after two consecutive empty lines. The footnote reference is simply the marker in square brackets, inside text. For example:
The Org homepage[fn:1] now looks a lot better than it used to. ... [fn:1] The link is: http://orgmode.org
Org mode extends the number-based syntax to named footnotes and optional inline definition. Using plain numbers as markers (as footnote.el does) is supported for backward compatibility, but not encouraged because of possible conflicts with LaTeX snippets (see Embedded LaTeX). Here are the valid references:
nameis a unique label word, or, for simplicity of automatic creation, a number.
[fn:: This is the inline definition of this footnote]
[fn:name: a definition]
[fn:name]to create additional references.
Footnote labels can be created automatically, or you can create names yourself.
This is handled by the variable
org-footnote-auto-label and its
#+STARTUP keywords. See the docstring of that variable
The following command handles footnotes:
When the cursor is on a footnote reference, jump to the definition. When it is at a definition, jump to the (first) reference.
Otherwise, create a new footnote. Depending on the option
definition will be placed right into the text as part of the reference, or
separately into the location determined by the option
When this command is called with a prefix argument, a menu of additional options is offered:
s Sort the footnote definitions by reference sequence. During editing, Org makes no effort to sort footnote definitions into a particular sequence. If you want them sorted, use this command, which will also move entries according to
org-footnote-section. Automatic sorting after each insertion/deletion can be configured using the option
org-footnote-auto-adjust. r Renumber the simple
fn:Nfootnotes. Automatic renumbering after each insertion/deletion can be configured using the option
org-footnote-auto-adjust. S Short for first
saction. n Normalize the footnotes by collecting all definitions (including inline definitions) into a special section, and then numbering them in sequence. The references will then also be numbers. This is meant to be the final step before finishing a document (e.g., sending off an email). d Delete the footnote at point, and all definitions of and references to it.
Depending on the variable
renumbering and sorting footnotes can be automatic after each insertion or