Math Typesetting

Fri, Mar 08, 2019

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} }}\]