Known Limitations

Known limitations

Numbering is fixed by the linter, not on insert

Inserting a new numbered footnote between two existing ones takes the next free number (1, 3, 2), not its place in the natural order (1, 2, 3).

Example sentence[^1] with two▊ footnotes[^2] already.
  
[^1]: Foo
[^2]: Bar

After insertion:

Example sentence[^1] with two[^3] footnotes[^2] already.
  
[^1]: Foo
[^2]: Bar
[^3]: Baz

The plugin's own Lint footnotes command renumbers footnotes in order of appearance and reorders their definitions to match (the Reindex rule, on by default). Turn on Lint on save or Lint on footnote creation in the settings if you want that to happen without running the command. If you use the Linter plugin as well, turn off its footnote rules so the two don't fight over the same footnotes.

Nested footnotes

A footnote inside another footnote's definition is not supported: Obsidian renders such nesting inconsistently, so the plugin refuses to create one there and the linter alerts you about hand-typed nesting.

Names with #

A footnote named [^a#b] renders in Reading view, but Obsidian's hover preview and its Footnotes sidebar can't find it, and neither can the plugin's popup editor. The plugin refuses # in names and prefixes, and the linter alerts you about existing ones.

Long-press menu on the phone

Obsidian builds the long-press menu on a footnote reference by itself and gives plugins no way to add to it, so Rename footnote can't appear there. On the phone, tap or long-press the footnote and then use the plugin's toolbar icon or the command palette.

Undo after a footnote created in a table cell

The cell and the note are separate editors, so undoing a footnote created from a table cell can take two undos. A notice tells you when the first undo has only removed the definition.