Hugoでkatexを使った数式が表示されなくて困った

Hugoで数式を表示するためにkatex@0.16.22を利用している。

https://katex.org/docs/browser

基本的に表示されるが表示されないこともあり困っていた。

結論

shortcodeを作る

以下のようなpassthroughするだけのショートコードを作る

{{- .Inner -}}

記事のmarkdown内で数式をショートコードで囲んで呼び出すだけ

$X_{n_1}$

原因

https://discourse.gohugo.io/t/one-of-several-latex-equations-is-not-rendered-by-katex/47790

markdownのレンダラーが失敗してるらしい。確かに少し長めの数式が失敗してた。