References and links in MyST

The MyST forms of the specimens on References and links, each rendered live by this page’s own Markdown parser. Their labels carry names of their own, because a label defined twice in one project is reported. Constructs MyST has no spelling of, on this site, have no section here.

Targets and {ref}

A target and its references

(ex-references-myst-target)=

This paragraph carries a target.
Link to it {ref}`with your own text <ex-references-myst-target>`
or as a Markdown link, [to the target](#ex-references-myst-target);
link to a section by its title: {ref}`authoring_references_citations`.

This paragraph carries a target. Link to it with your own text or as a Markdown link, to the target; link to a section by its title: Citations.

Hyperlinks

Hyperlinks

An inline link to [Docutils](https://docutils.sourceforge.io/),
a reference-style one to [MyST-Parser][ex-references-myst],
and an autolink, <https://www.sphinx-doc.org/>.

[ex-references-myst]: https://myst-parser.readthedocs.io/

An inline link to Docutils, a reference-style one to MyST-Parser, and an autolink, https://www.sphinx-doc.org/.

Footnotes

Footnotes

A numbered footnote [^1] and a named one [^ex-references-myst-note],
referred to twice [^ex-references-myst-note].

[^1]: Numbered in the order it is first referenced.
[^ex-references-myst-note]: Named, and numbered the same way.

A numbered footnote [1] and a named one [2], referred to twice [2].

The two definitions are rendered at the foot of this page.

Documents, terms and {any}

Documents, terms and any

See {doc}`rst_basics`, or {doc}`the tables page </authoring/rst_tables>`.
The {term}`MyST specimen term` is defined on another page,
and {any}`authoring_references_footnotes` finds a section by its label.

See reStructuredText basics, or the tables page. The MyST specimen term is defined on another page, and Footnotes finds a section by its label.

Downloads

A download

Save {download}`the builders table </../specimens/tables/builders.csv>`
to compare the builders offline.

Save the builders table to compare the builders offline.

Note

ubc build pdf cannot place a {download} link yet (it reports one as build.pdf_block_unsupported), so the PDF shows this specimen’s source only.

---

[1]

Numbered in the order it is first referenced.

[2] (1,2)

Named, and numbered the same way.