Add footnote syntax?
See original GitHub issueAs discussed in #31 it appears that people are for a footnote syntax, as implemented in some flavours of Markdown (see Extended Syntax):
Here's a simple footnote,[^1] and here's a longer one.[^bignote]
[^1]: This is the first footnote.
[^bignote]: Here's one with multiple paragraphs and code.
Indent paragraphs to include them in the footnote.
Can we come to a decision on this, bearing in mind
- that this syntax extension is not strictly compliant with CommonMark, as discussed here
- That (as with any syntax extension) this would incur some parsing performance cost (although probably minimal)
Note these footnotes would be inherently auto-numbered, as can be tried in the VS Code standard preview (GitHub markdown does not support footnotes)
paging @choldgraf @mmcky @jstac @akhmerov @najuzilu
Issue Analytics
- State:
- Created 4 years ago
- Comments:22 (22 by maintainers)
Top Results From Across the Web
Insert footnotes and endnotes - Microsoft Support
On the References tab, select Insert Footnote or Insert Endnote. On the References tab choose Insert Footnote. Enter what you want in the...
Read more >What Are Footnotes? | Guide with Word Instructions - Scribbr
Select the “References” tab at the top, and then select “Insert Footnote.” Type whatever text you want into the footnote that appears. Inserting...
Read more >What Are Footnotes and How Do You Use Them? - Scribendi
Footnotes are notes that are placed at the end of a page and used to reference parts of the text (generally using superscript...
Read more >Footnotes - Overleaf, Online LaTeX Editor
An online LaTeX editor that's easy to use. No installation, real-time collaboration, version control, hundreds of LaTeX templates, and more.
Read more >How to Add/Set Footnotes in LaTex - Resurchify
In this section, we will learn how to add footnotes in LaTeX. It is very simple and straightforward to add a footnote in...
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
I’d say no because its pretty non-standard and could just as easily be handled in a simple extension:
rather than introducing more complexity into the parser, leading to a slower parse and more potential bugs.
yeah, well it would probably just directly go from
[^this syntax]
to the docutils node for a footnote (at least, I think there’s a special node for this). If we wanted to add an in-line role for a short-hand, it might be something like{ft}`This is my footnote text`