KaTeX#

Render math typesetting with KaTeX. The library is loaded automatically on first use.

Activation#

KaTeX is activated on the page by the first use of the shortcode or a katex code block. You can force activation with {{< katex />}}, then use delimiters anywhere on the page.

Block Rendering#

Three equivalent ways to render display math:

  • Shortcode

    {{< katex display=true >}}
    f(x) = \int_{-\infty}^\infty
    \hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
    {{< /katex >}}
  • Code block

    ```katex
    f(x) = \int_{-\infty}^\infty
    \hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
    ```
  • Dollar delimiters

    $$
    f(x) = \int_{-\infty}^\infty
    \hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
    $$

Result:

$$ f(x) = \int_{-\infty}^\infty\hat f(\xi),e^{2 \pi i \xi x},d\xi $$

Inline Rendering#

Syntax Output
{{< katex >}}\pi(x){{< /katex >}} \( \pi(x) \)
\\( \pi(x) \\) \( \pi(x) \)

Configuration#

Override KaTeX options by creating assets/katex.json. For example, to enable $...$ inline delimiters

{
  "delimiters": [
    {"left": "$$", "right": "$$", "display": true},
    {"left": "$", "right": "$", "display": false},
    {"left": "\\(", "right": "\\)", "display": false},
    {"left": "\\[", "right": "\\]", "display": true}
  ]
}

See KaTeX options for all available settings.