在 Typecho 中引入 KaTeX 来渲染数学公式,主要是在当前使用的主题模板文件中添加 KaTeX 的 CDN 链接和初始化配置。
⚙️ 方法一:通过修改主题文件手动添加(推荐)
这个方法不依赖插件,兼容性较好,适用于大多数 Typecho 主题。
操作步骤:
- 找到并编辑文件:在 Typecho 后台的
/usr/themes/目录下,找到你当前正在使用的主题文件夹,然后编辑其中的header.php文件。 - 粘贴代码:将以下代码粘贴到
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 $$发布或预览文章,如果能正常显示为数学公式,就说明设置成功了。