Math

Zettlr supports writing math and formulae using the KaTeX library.

To insert math code, enclose your formulae with dollar signs ( $…$ ). To add a math block, use ($$…$$) instead.

Note

To prevent confusion with amounts of money, spaces between inline math and the dollar signs are not allowed.

By default, math is rendered using syntax highlighting. However, Zettlr can also pre-render math content. To do so, ensure to activate the corresponding renderer in the settings, and make sure your rendering mode is set to “Preview,” not “raw.”

Everybody should know Euler's formula: $e^{ \pm i\theta } = \cos \theta \pm i\sin \theta$

These are Euler's most famous equations:

\begin{aligned} e^{ \pm i\theta } & = \cos \theta \pm i\sin \theta \\ e^{i \pi} & = -1 \end{aligned}

Examples of math equations. Click to view Markdown source:

Everybody should know Euler's formula: $e^{ \pm i\theta } = \cos \theta \pm i\sin \theta$

These are Euler's most famous equations:

$$
\begin{aligned}
e^{ \pm i\theta } & = \cos \theta \pm i\sin \theta    \\
e^{i \pi} & = -1
\end{aligned}
$$

Tip

KaTeX is almost fully compatible with MathTeX. However, some discrepancies remain. If you export a document containing math to LaTeX, ensure that the code blocks render appropriately. For HTML exports, you can specify the KaTeX library (the default is MathJax).

A complete documentation for all supported functions and symbols can be found on the KaTeX homepage: katex.org/docs/supported.html.

Chemical Symbols

Zettlr also supports chemical symbols with scientific inferiors and charge indicators using the mhchem library.

You can find a documentation on how to utilize its syntax on its homepage: mhchem.github.io/MathJax-mhchem.

Math During Export

While Zettlr uses KaTeX for preview purposes, exported math may differ. Exporting to PDF will cause the standard LaTeX math engine to take care of rendering the code, while exporting to HTML will by default make use of MathTeX.

You can customize how math is being treated on export by adapting your YAML frontmatter or profiles.