Text formatting

To annotate single words, you use inline markup. The markup encloses the word(s) and you do not need to begin a new line.

Inline markup allows you to:

  • Emphasize text

  • Link to external resources with hyperlinks

  • Create internal cross-references

  • Create index entries

  • Create Bibliographic entries

Text markup

General text markup

The simplest form of inline markup is to emphasize text. typical AsciiDoc allows you to:

  • Bold text by wrapping text with asterisks (*)

  • Italicise words by wrapping text with underscores (_)

  • Apply monospace formatting by wrapping text with backticks

  • Superscript and subscript characters (like CO2 or x4)

Example 1. Example of general text markup syntax
*bold*
_italic_
`monospace`
^superscript^
~subscript~

Metanorma extends these simple formats with:

  • Strikethrough text (strike through text)

  • Smallcaps text (small caps text)

  • Underline text (underline text)

[strike]#strike through text#
[smallcap]#small caps text#
[underline]#underline text#
Illustration of strikethrough text in Metanorma
Figure 1. Illustration of strikethrough text in Metanorma.
Illustration of small caps text in Metanorma
Figure 2. Illustration of small caps text in Metanorma.
Illustration of underlined text in Metanorma
Figure 3. Illustration of underlined text in Metanorma.

OGC specific text markup

Metanorma-OGC supports highlighting of text [added in https://github.com/metanorma/metanorma-ogc/releases/tag/v1.2.16]:

This is #text to be highlighted#.

Character substitutions

Metanorma supports automatic character replacements, for example the copyright symbol © can be entered using ©.

Metanorma also recognizes HTML and XML character references, as well as decimal and hexadecimal Unicode code points.

Note
For more information about automatic character replacements, see AsciiDoc documentation.

Footnotes

General

Footnotes are a great option to add a remark to your content without disturbing reading flow.

In standards however, footnotes are discouraged as they hide potentially important information in the footer. It also becomes unclear whether the footnote is normative or informative in nature.

Single-line footnotes

Footnotes can be added to the document using the footnote command (footnote:[]).

Just add the footnote where you want it to appear, like this:

Oryza sativa [1], is rice that is farmed commercially.

Multi-paragraph footnotes

Metanorma provides the footnote command footnoteblock:[id] which allows multi-paragraph notes to be treated as footnotes.

Multi-paragraph footnotes can be entered using the command footnoteblock:[id] [added in https://github.com/metanorma/metanorma-standoc/releases/tag/v1.6.4], where id is the identifier of a note containing the contents of the footnote.

Example 2. Example of a multi-paragraph footnote
This is a paragraph.footnoteblock:[id1] This continues the paragraph.

[[id]]
[NOTE]
--
This is

a multi-paragraph

footnote
--
Note
The popular AsciiDoc processor, Asciidoctor, supports only single-paragraph footnotes through its footnote command (which can only contain a single line of text).

1. Sativa means "cultivated"