Including equations in DITA content

By Jakobswiki (Own work) [CC BY 3.0 (], via Wikimedia Commons

Sample Butler volmer equation. What DITA elements would you use to display this equation?

There are three possible containers for equations in the equation domain: equation-inline, equation-block, and equation-figure. Choose the DITA elements that makes the most sense for your equations: inline, in a separate block, and/or an equation or series of equation with a caption.

For a single equation:

Use equation-inline and equation-block elements to represent a single equation.

For inline equations use equation-inline. Inline equations allow a smooth flow of the sentence that contains the inline equation. Typically, inline equations are not numbered. (For inline equations, numbering could create ambiguity if the number was or was not part of the equation itself.)

To present an equation outside of the sentence flow, use, equation-blockBlock equations may be numbered (numbering is optional). [Inline equations are not numbered largely because it could be visually ambiguous as to whether a and it would also disrupt the flow of the sentence that contains the inline equation.]

For multiple equations, or for equations with a caption:

Use the equation-figure element to represents a “display” equation that contains one more distinct equations. The equation-figure element may be numbered and may have a caption. The equation-figure element is a specialization of <fig>. With an equation-figure element, individual equations can have their own numbering.