# How to render math equations on your Minimal Mistakes

You need MathJax if you want to render mathematical equations on your Minimal Mistakes website.

I first learned about it from the blog post by Peter Willis (thanks, Peter!) However, I couldn’t enable MathJax even after following his instructions. So here’s what I did.

### 1.

Add this snippet at the end of the scripts.html which is in the _includes folder:


<script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
<script id="MathJax-script" defer
src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js">
</script>


The MathJax documentation says that with this snippet you won’t need to change anything with each new version of MathJax.

### 2.

Enable MathJax in _config.yml by adding mathjax: true to the page defaults

# Defaults
defaults:
# _posts
- scope:
path: ""
type: posts
values:
layout: single
author_profile: true
share: true
related: true
mathjax: true


Note: If you are using Docker, don’t forget to rebuild your container after making changes to _config.yml.

docker build -t minimal-mistakes .


Basically that’s it. Try rendering $$y_0$$ using \$$ and \$$ delimeters for inline equations.

Use \$ and \$ to display equations like this one:

$f(a) = \frac{1}{2\pi i} \oint_\gamma \frac{f(z)}{z-a} dz$

Note: If things don’t work, check if the MathJax script is added to the page using Developer tools.

Tags: