ox-html-markdown-style-footnotes version 0.3.0: Support labeled footnotes

By . Published on 2025-11-15. Last updated on 2025-11-20.

The newly released version 0.3.0 of ox-html-markdown-style-footnotes adds support for Org 9.7 by supporting “labeled” footnotes.

Support labeled footnotes

Newer versions of Org1 use footnote labels as their anchors. For example, when creating a footnote with the label labeled: 

Hello, world![fn:labeled]

[fn:labeled] A footnote.

In previous versions of ox-html-markdown-style-footnotes, the example above would produce a footnote with fn.1 as the anchor: 

<ol>
  <li id=\"fn.1\" class=\"footdef\" role=\"doc-footnote\" tabindex=\"-1\">
    <p class=\"footpara\">A footnote.</p>
    <p class=\"footpara\">\nWith a second paragraph.\n</p>
    <a href=\"#fnr.1\" role=\"doc-backlink\">↩&#65038;</a>
  </li>
</ol>

This produces broken links, as Org now uses fn.labeled when linking to this footnote from the footnote reference.

Version 0.3.0 of ox-html-markdown-style-footnotes now uses the label if available and falls back to numbered foonotes. The example above now produces a “labeled” footnote: 

<ol>
  <li id=\"fn.labeled\" class=\"footdef\" role=\"doc-footnote\" tabindex=\"-1\">
    <p class=\"footpara\">A footnote.</p>
    <p class=\"footpara\">\nWith a second paragraph.\n</p>
    <a href=\"#fnr.labeled\" role=\"doc-backlink\">↩&#65038;</a>
  </li>
</ol>

  1. ox-html-markdown-style-footnotes now targets Emacs 30.2, which bundles with Org 9.7.13.

    ↩︎