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.

## Examples

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