在 Typecho 中引入 KaTeX 来渲染数学公式,主要是在当前使用的主题模板文件中添加 KaTeX 的 CDN 链接和初始化配置。

⚙️ 方法一:通过修改主题文件手动添加(推荐)

这个方法不依赖插件,兼容性较好,适用于大多数 Typecho 主题。

操作步骤:

  1. 找到并编辑文件:在 Typecho 后台的 /usr/themes/ 目录下,找到你当前正在使用的主题文件夹,然后编辑其中的 header.php 文件。
  2. 粘贴代码:将以下代码粘贴到 header.php 文件的 <head> 标签内即可。
<!-- 引入 KaTeX 核心样式和脚本 -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/katex.min.css">
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/katex.min.js"></script>
<!-- 引入自动渲染扩展 -->
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/auto-render.min.js" 
    onload="renderMathInElement(document.body, {
        delimiters: [
            {left: '$$', right: '$$', display: true},  // 行间公式(独立成行)
            {left: '$', right: '$', display: false},    // 行内公式
            {left: '\\(', right: '\\)', display: false},
            {left: '\\[', right: '\\]', display: true}
        ],
        throwOnError: false
    });">
</script>

🔌 方法二:使用插件

如果你觉得手动修改模板不方便,也可以尝试使用插件。

一个相关的插件是 MarkdownKatex-typecho。不过需要提醒你的是,这个插件比较旧(上次更新大约是2018年),在一些较新的 Typecho 版本(如 v1.2.1)上可能会出现兼容性问题,例如导致文章页面无法加载。如果使用插件后遇到问题,建议还是用回手动添加的方法。

✅ 验证与测试

完成上述任一操作后,你可以写一篇文章来测试,内容如下:

质能方程可以用行内公式 $E = mc^2$ 表示。

行间公式(欧拉公式)如下:
$$ e^{i\pi} + 1 = 0 $$

发布或预览文章,如果能正常显示为数学公式,就说明设置成功了。