KaTeX Support

Posted on by Munif Tanjim 2 mins read

For enabling KaTeX, add this to your content’s frontmatter:

---
katex: true
---

KaTeX Syntax for Markdown

In your Markdown content, use \\(…\\) delimiters for in-line mathematics.

For mathematics blocks you can use either $$…$$ or \\[…\\] as delimiters.

Here’s an example Markdown content:

When \\( a \ne 0 \\), there are two solutions to

$$ ax^2 + bx + c = 0 $$

and they are:

\\[ x = {-b \pm \sqrt{b^2-4ac} \over 2a} \\]

Output:

When \( a \ne 0 \), there are two solutions to

$$ ax^2 + bx + c = 0 $$

and they are:

\[x = {-b \pm \sqrt{b^2-4ac} \over 2a}\]

Customize KaTeX Configuration

You can customize the default behavior of KaTeX if you want.

Minimo picks up configuration for KaTeX from the /data/config/katex.json file.

The default configuration options look like this:

{
  "library": {
    "js": {
      "main": "//unpkg.com/katex/dist/katex.min.js",
      "autoRender": "//unpkg.com/katex/dist/contrib/auto-render.min.js"
    },
    "css": {
      "main": "//unpkg.com/katex/dist/katex.min.css"
    }
  },
  "options": {}
}
  • library [Object]:
    • js [Object]:
    • css [Object]:
      • main [String]: URL for the main KaTeX stylesheet
  • options [Object]:

So, if you want to tinker with it’s configuration options:

  • Create a /data/config/katex.json file in your site’s repository
  • Copy the default configuration options
  • Start hacking