Mathematical notation in a Jekyll project can be enabled by using third party JavaScript libraries.

In this example we will be using KaTeX

• Create a partial under _includes/math.html
• Within this partial reference the Auto-render Extension or host these scripts locally.
• Include the partial in your templates like so:

{% if site.math.enable or page.math %}
{% include math.html %}
{% endif %}

• To enable KaTeX globally set the parameter math to true in a project’s configuration
• To enable KaTeX on a per page basis include the parameter math and set it to true in the front matter of the page.

Note: Use the online reference of Supported TeX Functions

Examples

Inline math: \(\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887...\)

Block math:

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