This article shows how to configure your site with heyo theme to display $\LaTeX$.

Math typesetting is achieved through JavaScript libraries. In heyo you have the option of using either MathJax 3 or KaTeX.

The libraries are in the math.html partial (/layouts/partials/math.html).

Global Configurations

Math typesetting can be globally enabled setting the param math in config.toml.

  • The param math.enable = true enables math typesetting for all pages.
  • The default library is MathJax, but it can be changed to KaTeX with math.use = "katex".

Per Page Basis

Even with math.enable = false in the config.toml you can typeset math on specific pages, all you need to do is put math = true in page front-matter.


In this examples we’re using MathJax.

Inline Math

MathJax is setup to use $...$ or \\(...\\) as the delimiters for inline math.

Suddenly we need to define $\varphi = \dfrac{1+\sqrt5}{2} = 1.6180\dots$

Will be rendered as:

Suddenly we need to define $\varphi = \dfrac{1+\sqrt5}{2}= 1.6180\dots$

Block Math

For block math the MathJax delimiters are $$...$$ or \\[...\\].

    \varphi = 1+\frac{1}{1+\frac{1} {1+\frac{1} {1+\cdots}}}

Will be rendered as:

$$ \varphi = 1+\frac{1}{1+\frac{1} {1+\frac{1} {1+\cdots}}} $$

Escaping \$

If you need to show the literal \$ in text you can escape it with \. If you’re using .md you need to escape the \.

So if you have A random amount between \\$5 and \\$10 in your .md file, after Hugo and MathJax process it the end result will be:

A random amount between \$5 and \$10