Footnotes and Sidenotes

Margin notes for asides, footnotes at the end of each section

A printed page can carry two kinds of note at once: short asides in the margin and longer notes at the foot of the page.Sidenotes are numbered 1, 2, 3 … by Tufte CSS’s counter. This page does the same. Its front matter sets footnoteplacement: section, so the real footnotes of each section are listed at the end of that section.a


  1. With the default footnoteplacement: page all footnotes are collected in one list at the end of the article. ↩︎

Notes in the margin

A Markdown footnote becomes a sidenote by default.Written [^aside]: no prefix, so it follows the page’s mode (sidenotes). The sidenote shortcode always does,Even on a page in endnotes mode. and a margin note has no number at all.A margin note, from the marginnote shortcode. Math works in every kind of note.For instance eiπ+1=0e^{i\pi} + 1 = 0.

Notes below the text

A label that starts with fn- keeps a Markdown footnote a real footnote,b and the footnote shortcode always gives one.c Because the page also has numbered sidenotes, footnotes are marked with letters (footnotestyle = "auto"), so the two sequences never look alike.

A footnote can be referenced twice;d both references link to the same item, and its backlinks return to each of them.d

A citation can go below the text as well. {{< cite keys="tufte2006" as="footnote" >}} puts the full reference in a real footnote,e while a plain cite keeps it in the margin.Edward R. Tufte. Beautiful Evidence. Graphics Press, LLC, first edition, May 2006. ISBN 0-9613921-7-7 The option citeas: footnote, in the front matter or under [params], does this for every cite of the page (or of the site); a single cite then returns to the margin with as="sidenote".


  1. Written [^fn-proof]. A real footnote can be long and hold several paragraphs, because the list below the section is block content.

    This is the second paragraph of the same footnote. ↩︎

  2. Written as {{< footnote >}}…{{< /footnote >}}. Inline Markdown, math such as ∑k=1nk=n(n+1)/2\sum_{k=1}^n k = n(n+1)/2 and citations work inside it. ↩︎

  3. This footnote is referenced twice in the same sentence. ↩︎ ↩︎

  4. Edward R. Tufte. Beautiful Evidence. Graphics Press, LLC, first edition, May 2006. ISBN 0-9613921-7-7 ↩︎

Choosing between them

Kind of noteUse
short aside, gloss, citationsidenote: {{< sidenote >}} or [^x]
unnumbered remark, small figure{{< marginnote >}}, {{< marginfigure >}}
proof, long digression, several paragraphsfootnote: {{< footnote >}} or [^fn-x]

Tufte’s own books use only sidenotes, and tufte-latex turns LaTeX’s \footnote into a sidenote.See the LaTeX to Hugo cheat sheet. Real footnotes are for documents that also need the classic article convention.

References

  1. Edward R. Tufte. Beautiful Evidence. Graphics Press, LLC, first edition, May 2006. ISBN 0-9613921-7-7.