This document should help with testing of footnotes support that
is introduced by the "markdown-footnotes" branch.
It might look pretty misformatted unless rendered by the proper Fossil
executable that incorporates the abovementioned branch.1
That is also a humble attempt to explore the robustness of the Markdown parser.
So please excuse for the mess in the source code of this document.
By no means the normal use of footnotes should look that scarry.
Developers are invited to add test cases here2. It is suggested that the more simple is a test case the earlier it should appear in this document.3
A footnote's label should be case insensitive4, it is whitespace-savvy and can even contain newlines.5
A labeled footnote may be referenced several times6.
A footnote's text should support Markdown markup7.
Another reference6 to the preveously used footnote.
Inline footnotes are supported.8
If undefined label is used9 then red "misref" is emited instead of
a numeric marker.misref
This can be overridden by the skin though.
The refenrence at the end of this sentence is the sole reason of
rendering of lost210.lost1 and
If several labeled footnote definitions have the same equal label then texts from all these definitions are joined.11
Footnotes
- ^ Footnotes is a Fossil' extention of Markdown. Your other tools may have limited support for these.
- ^ History of test/markdown-test3.md
- ^ So that simple cases are processed even if a glitch happens for more tricky cases.
- ^ And also tolerate whitespaces.
- ^ But at a footnote's definition it should still be written within square brackets on a single line.
- ^ a b Each letter on the left is a back-reference to the place of use. Highlighted back-reference indicates a place from which navigation occurred12.
- ^ E.g. emphasis, and so on. BTW, this note may not have a backreference to the "stray".
- ^
These may be usefull for adding
smallcomments. - ^ For example due to a typo.
- ^ This note was defined in the middle of the document. It references its previous13 and the forthcoming12 siblings.
- ^
- This came from the begining of the document.
- And that came from the end of the document.
- ^ a b c This note was defined at the end of the document. It defines an inline note.14
- ^ This note was defined at the begining of the document.
- ^ This is inline note defined inside of a labeled note12.
- ^ Misreference
-
[^
i am strayed]This should be presented **verbatim** (without any [markup][^]) in the end of the footnotes. Default skin renders label in red bold font and the main text as gray. Other styling may also apply. -
[^
another stray]Just to verify the correctness of ordering and styling.