Skip to content

Accessible Footnotes

The Framework supports accessible footnote references using a simple authoring convention.

Creating a Footnote Reference

  1. Create an HTML Anchor on the footnote using the block Advanced panel.
  2. Name the anchor using the format doc-footnote-# where # is a unique positive integer (e.g. doc-footnote-1).
  3. Create a link from the footnote reference to the matching anchor.

About the Naming Convention

The doc-footnote-# naming convention is a Framework standard that allows footnote references and destinations to be recognized automatically during rendering. This enables the Framework to add consistent accessibility enhancements without requiring authors to manually manage ARIA attributes or additional markup.

Automatic Enhancement

When the Framework encounters a link whose destination matches the doc-footnote-# convention, it automatically enhances the rendered output. The Framework only enhances content that follows the doc-footnote-# naming convention. Other named anchors continue to behave as standard HTML fragment links.

This includes:

  • identifying the reference as a footnote reference;
  • identifying the destination as a footnote;
  • generating an accessible name for the reference;
  • preserving any manually supplied accessibility attributes.

These enhancements are applied automatically during rendering and do not modify the stored block content.

Formats

Superscript

Footnote reference using superscript inline style 1

Superior

Footnote reference using superior inline style 2

Normal

Footnote reference using inline link [3]

Footnotes

Each footnote has an HTML Anchor assigned via the block Advanced panel.

  1. This is the first footnote.
  2. This is the second footnote.
  3. This is the third footnote.