Math Typesetting

一个简短的介绍对于在Hugo中使用KaTeX。

这篇文章是对Hugo默认生成的文章的翻译版。

在 Hugo 项目中,可以通过使用第三方 JavaScript 库来启用数学公式支持。

在这个例子中,我们将使用 KaTeX

  • /layouts/partials/math.html 下创建一个 局部模板,命名为math.html
  • 在该 partial 中引用 Auto-render 扩展,或将这些脚本托管在本地。
  • 像下面这样在你的模板中引入该 partial:
1
2
3
{{ if or .Params.math .Site.Params.math }}
{{ partial "math.html" . }}
{{ end }}
  • 要全局启用 KaTeX,需在项目配置中将参数 math 设置为 true
  • 要在单个页面启用 KaTeX,需在内容文件中包含参数 math: true

注意: 请参考 支持的 TeX 函数 在线文档

例子

行内公式: $\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…$

块级公式:

$$ \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } $$
根据CC BY-NC-SA 4.0许可
最后更新于 2026-01-29