KaTeX Rendering

KaTeX Options (katex)

Defines optional settings for overriding site configuration for the KaTeX markup option, which enables you to use KaTeX markup in your content with an image link (that has the chem:, katex:, or math: prefix), codeblock (whose language ID is chem, katex, and math), and even with KaTeX’s own open/closing tags in normal Markdown content if always_load is set to true.

With KaTeX, you can write mathematical and chemical formulae in plaintext and render them as beautiful formula on your site.

JSON Schema

Definition
{
  "$id": "https://platen.io/schemas/platen/content/markup/katex/schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "Optional settings for overriding KaTeX configuration on a content page.\n\nhttps://platen.io/schemas/platen/content/markup/katex/",
  "properties": {
    "always_load": {
      "default": false,
      "description": "Always load KaTeX for auto-rendering for this content.\n\nhttps://platen.io/schemas/platen/content/markup/katex/#always_load",
      "title": "Always Load KaTeX",
      "type": "boolean"
    }
  },
  "title": "KaTeX Options",
  "type": "object"
}

Always Load KaTeX (always_load)

Specifies whether this content should always load the KaTeX style and script modules and auto-render any valid KaTeX markup. By default, the modules and style code are only added to pages where KaTeX markup is used with the codeblock render hook, image render hook, or when the site has platen.markup.katex.always_load set to true.

When this setting is set to true, the modules are added to this content and will always be called to auto-render any valid KaTeX found in the content. This is useful when you want to use inline KaTeX without the shortcode.

This setting overrides the site’s always_load setting for this content only. The default value is false.

Edit this page