diff --git a/docs/syntax/footnotes.md b/docs/syntax/footnotes.md index a070c748a..231a07d73 100644 --- a/docs/syntax/footnotes.md +++ b/docs/syntax/footnotes.md @@ -183,9 +183,10 @@ Each footnote should contain a single, focused piece of information. If you find Before adding footnotes, consider whether: - The information is important enough to be in the main text. -- A link to external documentation would be more appropriate. -- An admonition (note, warning, etc.) would be clearer. +- A [link](links.md) to external documentation would be more appropriate. +- An [admonition](admonitions.md) (note, warning, etc.) would be clearer. +- A [code callout](code.md#code-callouts) would work better for code blocks. ### Numbering -Footnotes are automatically numbered in order of first reference, regardless of the identifier you use in your source. This means `[^zebra]` appearing before `[^apple]` will be numbered as footnote 1. \ No newline at end of file +Footnotes are automatically numbered in order of first reference, regardless of the identifier you use in your source. This means `[^zebra]` appearing before `[^apple]` will be numbered as footnote 1.