Markdown Footnotes and References: A Complete Guide

Footnotes let you add supplementary information without interrupting the flow of your text. They are essential for academic papers, research notes, legal documents, and any writing that needs citations or clarifications. Markdown supports footnotes through a simple, widely adopted extension.

Quick Answer: A Markdown footnote has two parts: a reference mark in the text ([^1]) and a definition anywhere in the document ([^1]: footnote text). Definitions are always rendered at the bottom regardless of placement. Both numeric ([^1]) and named ([^author]) references are supported in most extended Markdown processors.

How Do You Add Footnotes in Markdown?

A footnote has two parts: the reference mark in the text and the footnote definition.

This claim needs a source[^1]. Another point worth noting[^2].

[^1]: Author Name, "Title of Work", Journal, 2025.
[^2]: See the full analysis in Appendix B.

The reference [^1] becomes a superscript link in the rendered output. The definitions can appear anywhere in the document, but they are always rendered at the bottom.

Named Footnotes

You are not limited to numbers. Named footnotes can make your source more readable:

Markdown was created by John Gruber[^gruber] in 2004.

[^gruber]: John Gruber, creator of Markdown and author of Daring Fireball.

Named references are especially useful in longer documents where numbered footnotes become hard to track.

Multi-Line Footnotes

Footnote definitions can span multiple lines. Indent continuation lines with two spaces:

[^details]: This is a longer footnote with multiple paragraphs.

  The second paragraph is indented with two spaces to indicate
  it belongs to the same footnote.

  You can also include code:

      console.log("inside a footnote");

Reference-Style Links

Markdown also supports reference-style links, which are different from footnotes but serve a similar purpose of keeping the source clean:

Read the [official guide][guide] for more details.
Check the [API reference][api] for endpoint documentation.

[guide]: https://example.com/guide "Getting Started Guide"
[api]: https://example.com/api "API Reference"

Reference-style links move URLs out of the text flow. This makes paragraphs easier to read in the source, especially when URLs are long.

Footnotes vs Reference Links

Feature	Footnotes	Reference Links
Purpose	Supplementary information	Clean link management
Rendered position	Bottom of document	Inline (as a regular link)
Syntax	[^id]	[text][id]
Supports multi-line	Yes	No
Numbering	Automatic	N/A

Use footnotes for commentary, citations, and asides. Use reference links to keep your paragraphs free of long URLs.

Use Cases

Academic Citations

The study found a significant correlation (p < 0.01) between
screen time and sleep quality[^smith2025].

[^smith2025]: Smith et al., "Screen Time and Sleep", Journal of
  Digital Health, Vol. 12, 2025.

Legal Disclaimers

This software is provided "as is"[^disclaimer].

[^disclaimer]: See LICENSE file for the full terms and conditions.
  No warranty is expressed or implied.

Technical Clarifications

The function uses a binary search algorithm[^complexity].

[^complexity]: Time complexity is O(log n). Space complexity is O(1).
  This assumes the input array is already sorted.

Rendering and Back-Links

When footnotes are rendered, each reference becomes a superscript number that links to the footnote at the bottom of the page. Each footnote definition includes a back-link (usually an arrow) that takes the reader back to where the reference appeared in the text.

This bidirectional linking makes footnotes genuinely useful for navigation, not just decoration.

Tips for Better Footnotes

• Keep footnotes concise. If the content is essential, it belongs in the main text.
• Use named references in longer documents to keep the source readable.
• Group related footnotes together in the source for easier maintenance.
• Avoid deeply nested or recursive footnotes. One level is enough.

Where Are Footnotes Most Useful?

Footnotes are most valuable in long-form writing where inline citations would disrupt reading flow. Researchers writing in Markdown benefit most: see the guide to Markdown for researchers for a full workflow including citations, LaTeX math, and PDF export. For general technical documentation, footnotes work well for edge-case clarifications and versioning notes. The complete syntax reference is in the Markdown cheat sheet.

Try It

Open edtr.md and add some footnotes to your document. The preview pane renders them at the bottom with automatic numbering and back-links. Both [^1] numeric and [^name] named styles are supported.