MathML and equation domains

The MathML and equation domains provide general containers for equations (inline, block, and display) and an integration with the MathML standard. The equation containers identify equations separate from the data that provides the equation content, which might take many forms, including MathML markup, images, and non-XML formats like TeX and ASCII equations.

These two domains provide support for mathematics elements:

MathML domain

Provides the <mathml> element, which is a specialization of <foreign>. The <mathml> element can contain direct MathML markup, or it can use the <mathmlref> element to include MathML markup that is stored in a separate, non-DITA document. When this domain is integrated without additional constraints, the <mathml> element is allowed wherever <foreign> is allowed.

The equation domain elements can be used to distinguish equations semantically. While authors can include the <mathml> element directly in content, the recommended best practice is to always include <mathml> within one of the equation domain elements or their semantic equivalent in a non-OASIS-defined DITA vocabulary.

Equation domain

Provides the <equation-inline>, <equation-block>, and <equation-figure> elements. This domain can be used independently of the MathML domain. The elements in the equation domain enable authors to clearly distinguish equations from other type of content; these markup distinctions can enable formatting distinctions, numbering of equations, and more.