Markdown syntax: Links
The link text is enclosed in square brackets, followed by parentheses containing the link and an optional title enclosed in double quotes. The text can be replaced by an image.
[text](link "optional title")
The link can be either
- a valid URI, e.g. https:, mailto:;
- an anchor to the same document;
- or any text you want to use internally via the OnLinkClick event.
If no alternate text or title is needed, inline links can simply be written between < > as long as a valid domain scheme is provided, such as <https://chessware.ch/markdown>. < > can even be omitted, e.g. https://chessware.ch/markdown. The later case depends on the ValidSchemes property.
References
Reference links are defined in a list of links, and the actual link is an ID (number or string) in that list. Reference links are useful if you need to have the same link multiple times in the document. It is also easier to update them without scrolling if they are at the beginning or end of the document.
The link text is delimited with square barckets and is followed by the link ID, as well in square brackets.
[Text][id]
References have their ID enclosed in square brackets, followed by a colon :, the link, and an optional title between double quotes ". Links can be anywhere in the document and need not be contiguous.
[id]: Link "Optional title"
The reference ID can be omitted if it is the same text as the link text (not case sensitive).
[Text][]
[Text]: Link "Optional title"
Anchors
Anchor links jump to anchor points (or bookmarks) within the same document.
Anchor jumps are only effective with TMDViewer. TMDLabel does not allow them, even if they are highlighted correctly, because it does not have a scroll option.
They can be inline or reference links with the same syntax but the link itself starts with an hash mark.
[Text](#link)
An empty anchor (that is a hash mark # not followed by any text) is valid and jumps to the top of the document.
[Text](#)
Anchors are automatically created from headings. To add one anywhere in the script, use text that starts with a hash mark # and is enclosed in curly braces.
{#anchor}
Tooltips
A tooltip is simply an inline link... without a link. When hovering, the cursor changes to a help cursor.
[Text]("Tooltip")
Footnotes
Footnotes allow you to add notes and references without cluttering the body of the document. A superscript number with a link appears where the footnote reference was added. A footnote reference is a caret ^ followed by an identifier enclosed in square brackets [ ]. The footnote itself has the same syntax, followed by a colon : and the text.
Text with a link to a footnote[^1].
[^1]: This is the footnote.
Footnote IDs can be alphabetic, but they are always converted to numeric values and renumbered in the order they appear.
Text with a link to a footnote[^footnote].
[^footnote]: This is the footnote, renumbered to 1.
Footnotes can be emphasized and may contain links.