Markdown Footnotes Test Document

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.¹
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 here². It is suggested that the more simple is a test case the earlier it should appear in this document.³

A footnote's label should be case insensitive⁴, it is whitespace-savvy and can even contain newlines.⁵

A labeled footnote may be referenced several times⁶.

A footnote's text should support Markdown markup⁷.

Another reference⁶ to the preveously used footnote.

Inline footnotes are supported.⁸

If undefined label is used⁹ 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 lost1 and lost2¹⁰.

If several labeled footnote definitions have the same equal label then texts from all these definitions are joined.¹¹

Several references should be recognized as several distinct numbers.¹²⁶

If markup is ambigous between a span-bounded footnote and a "free-standing" footnote followed by another footnote then interpret as the later case. This facilitates the usage in the usual case when several footnotes are refenrenced at the end of a phrase.^13614misref

A footnote may not be empty(^) or consist just of blank characters.(^
)

The same holds for labeled footnotes. If definition of a labeled footnote is blank then it is not accepted by the first pass of the parser and is recognized during the second pass as misreference.^misref:

It is possible to provide a list of classes for a particular footnote and all its references. This is achieved by prepending a footnote's text with a special token that starts with dot and ends with colon.¹⁵
This feature is "opt-in": there is nothing wrong in starting a footnote's text with a token of that form while not defining any corresponding classes in the stylesheet.¹⁶ If a footnote consists just of a valid userclass token then this token is not interpreted as such, instead it is emitted as plain text.¹⁷¹⁸¹⁹

Footnotes

---

1. ^{^} Footnotes is a Fossil' extention of Markdown. Your other tools may have limited support for these.
2. ^{^} History of test/markdown-test3.md
3. ^{^} So that simple cases are processed even if a glitch happens for more tricky cases.
4. ^{^} And also tolerate whitespaces.
5. ^{^} But at a footnote's definition it should still be written within square brackets on a single line.
6. ^{^ a b c d} Each letter on the left is a back-reference to the place of use. Highlighted back-reference indicates a place from which navigation occurred²⁰.
7. ^{^} E.g. emphasis, and so on. BTW, this note may not have a backreference to the "stray".
8. ^{^} These may be usefull for adding small comments.
9. ^{^} For example due to a typo.
10. ^{^} This note was defined in the middle of the document. It references its previous²¹ and the forthcoming²⁰ siblings.
11. ^{^}
    • This came from the begining of the document.
    • Labeled footnote definition may appear anywhere. That part came from inside of an inline style definition.
    • And that came from the end of the document.
12. ^{^} There should be an interval between numbers.
13. ^{^} Which is common in the scientific publications.
14. ^{^} All these four should be parsed as "free-standing" footnotes
15. ^{^} .alpha-Numeric123.EXAMPLE: This token defines a dot-separated list of CSS classes which are added to that particular footnote and also to the corresponding reference(s). Hypens ('-') are also allowed. Classes from the token are tranformed to lowercase and are prepended with "fn-upc-" to avoid collisions.
16. ^{^} .unused.classes: In that case text of the footnote just looks like as if no special processing occured.
17. ^{^} .bare.classlist.inside.inline.footnote:
18. ^{^} .at.the.1st.line.of.labeled.footnote.definition:
19. ^{^} .at.the.2nd.line.of.labeled.footnote.definition:
20. ^{^ a b c} This note was defined at the end of the document. It defines an inline note.²²
21. ^{^} This note was defined at the begining of the document.
22. ^{^} This is inline note defined inside of a labeled note²⁰.
23. ^{^ a b c} Misreference
24. [^ i am strayed ]

    This should be presented **verbatim** (without any [markup][^])
    in the end of the footnotes.
    
    Default skin renders label in red font and the main text in gray.
    Other styling may also apply.

25. [^ another stray ]

    Just to verify the correctness of ordering and styling.