Footnotes

In this article

Footnotes typically contain optional or tangential information which may be pertinent to the context, but which isn’t necessary to complete a task or understand a concept, and which doesn’t rise to the level of requiring its own Note box or admonition.

For example, you can use a footnote to link to additional information which can’t be organically included within the text as an inline link.

Example
Footnote markdown rendered on Docs site

AsciiDoc

AsciiDoc supports footnotes out of the box. Note that in AsciiDoc, footnotes always appear at the bottom of the page.

To create a footnote, place a footnote link immediately after the end of the sentence, clause, word, abbreviation, or other item to which the footnote applies, without adding a space. The link should follow any punctuation marks, other than dashes.

Example

A statement.footnote:[Clarification about this statement.]

The above would render as follows:

A statement.[1]

1. Clarification about this statement.