Foreign formal-language content a DSL owns — mathematics and code, embedded when small and exhibited when large.
<align>Compiles to eHTML <align>.
<align>
x^2 + y^2 &= z^2 \\
a + b &= c
</align>
Two aligned equations. The & marks the alignment column (here,
the = sign). Handler wraps in \begin{aligned}...\end{aligned}
(KaTeX-compatible variant of LaTeX’s align).
<cases>Compiles to eHTML <cases>.
<cases>
x^2 & \text{if } x \ge 0 \\
-x^2 & \text{if } x < 0
</cases>
A two-case piecewise definition. Handler wraps in
\begin{cases}...\end{cases}.
<code>Compiles to eHTML <code>.
The function is `factorial`.
The function is factorial.
Plain markdown backticks produce inline <code>. The most common authoring path.
<code-block>Compiles to eHTML <code-block>.
<``` python | print("hello, world") ```>
print("hello, world") The triple-backtick sigil. The first positional token is the
language (emitted as a language-X class on the <code>); the pipe
separates it from the verbatim, whitespace-preserving content — the
pipe-form padding (the spaces around the content) is KEPT, since
whitespace in code is significant and visible to the reader. (#327)
<display-math>Compiles to eHTML <display-math>.
<$$ \sum_{i=1}^{n} x_i = X $$>
The $$ sigil. Display-mode LaTeX rendered by KaTeX on its own line;
numbered by default (the equation number is appended after the KaTeX
output).
<eqnarray>Compiles to eHTML <eqnarray>.
<eqnarray>
f(x) &=& x^2 \\
g(x) &=& 2x
</eqnarray>
Two equations rendered via KaTeX’s aligned env (the supported
equivalent of LaTeX’s eqnarray).
<inline-code>Compiles to eHTML <inline-code>.
Assign with <` x = 1 `> at the top of the function.
Assign with x = 1 at the top of the function.
The single-backtick sigil. With no pipe, the whole body is opaque code content rendered as <code> (the same output as a markdown backtick span). Whitespace in code is significant and preserved, so the pipe-form padding stays INSIDE the <code>. (#327)
<inline-math>Compiles to eHTML <inline-math>.
The identity <$ a^2 + b^2 = c^2 $> holds for right triangles.
The identity
The $ sigil. Opaque LaTeX content rendered inline by KaTeX and
wrapped in <inline-math> for CSS targeting. The sigil carries no
attributes — id and classes are not supported for inline math.
<math>Compiles to eHTML <math>.
<math>
E = mc^2
</math>
Long-form <math> block. Semantically equivalent to the
<$$ E = mc^2 $$> display-math sigil — both render block-level
LaTeX math via KaTeX. Use the long-form when the source is
multi-line or when explicit tag bounds aid readability; use the
sigil for brevity.
<matrix>Compiles to eHTML <matrix>.
<matrix>
1 & 2 \\
3 & 4
</matrix>
A 2×2 matrix. The handler wraps the body in
\begin{matrix}...\end{matrix} before KaTeX renders.