Metanorma
On this page

Cross-references

General

Cross-references are an integral part of standards. The main mechanism for references are anchors and destinations.

There are the following types of cross-references:

The following clauses will provide the basics on how cross-referencing works in Metanorma.

Internal references

General

To link to an important section, table, figure, formula, or list item in your document:

  1. Set an anchor using double square brackets before the content you want to reference: \[[anchor]].
  2. To reference an anchor, type the anchor name like this \<<anchor>>.
  3. To set an alternative text other than the anchor text, append the text inside the brackets using a comma.

Auto-numbering of references

Metanorma automatically numbers and names references; because they are auto-numbered, they will be renumbered automatically if you insert any new text of the same type.

Metanorma markup is serialized into XML, hence the anchor should follow the XML namespace conventions.

i.e., an anchor name name must not contain:

  • colons
  • whitespaces
  • words starting with numbers

If you want to learn more about the technical aspects of cross-references, read Deep-dive into cross-references.

Hyperlinks

It is easy to include links to external sources in Metanorma, and sources to files within the same project.

To reference an internal source:

  1. Use the link command to include a link to a file. The syntax looks like this: \PATH[].
  2. Add link text in square brackets after the path.

To reference an external source:

  1. Paste the URL into the document.
  2. Add link text in square brackets after the URL (optional) URL[Link text].