1. Katex介绍
📐 KaTeX 介绍文档
KaTeX 是一个由 Khan Academy 开发的快速、可靠的数学公式渲染引擎,支持将 LaTeX 数学表达式渲染为网页可视化格式。
🎯 什么是 KaTeX?
KaTeX(Khan Academy TeX)是一个基于 JavaScript 的数学公式渲染引擎,它的特点包括:
- ✅ 渲染速度快:比 MathJax 更轻量级。
- ✅ 不依赖 DOM 重排:适合客户端和服务器端渲染。
- ✅ 高兼容性:可在大多数现代浏览器中使用。
- ✅ 支持LaTeX语法:兼容多数常见数学公式。
🚀 KaTeX 与 MathJax 对比
特性 | KaTeX | MathJax |
---|---|---|
渲染速度 | 快 🚀 | 慢一些 🐢 |
兼容性 | 高 | 高 |
文件大小 | 小 | 相对较大 |
LaTeX支持 | 较多,但不完全 | 更全面 |
渲染方式 | 静态渲染 | 动态解析 DOM |
🧰 如何使用 KaTeX?
方式 1:CDN 引入(推荐)
<!-- 在 HTML 中引入 KaTeX -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.css">
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/contrib/auto-render.min.js"
onload="renderMathInElement(document.body);"></script>
添加完成后,在 HTML 页面中可以使用 \( ... \)
或 {% math %} ... {% endmath %}
来书写数学公式。
方式 2:npm 安装(适用于前端项目)
npm install katex
并在代码中引用:
import katex from "katex";
import "katex/dist/katex.min.css";
katex.render("c = \\pm\\sqrt{a^2 + b^2}", element);
✍️ 支持的语法示例
行内公式(Inline)
这是一个行内公式:\( E = mc^2 \)
效果:
这是一个行内公式:( E = mc^2 )
块级公式(Block)
{% math %}
\int_{a}^{b} x^2 \, dx
{% endmath %}
效果:
常见表达式示例
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
A = \pi r^2
\lim_{x \to \infty} \frac{1}{x} = 0
\sum_{i=1}^n i = \frac{n(n+1)}{2}
💡 常见使用场景
- 技术博客(如 Hexo、Hugo、Jekyll)
- Markdown 笔记平台(如 Obsidian、Typora)
- 在线学习平台(如课程系统)
- 教育类网站、考试系统、作业自动批改平台
📦 支持的函数与符号
KaTeX 支持绝大多数常见 LaTeX 数学语法,包括但不限于:
- 分数
\frac{a}{b}
- 开方
\sqrt{a}
,\sqrt[n]{a}
- 上下标
x_i
,x^2
- 极限
\lim_{x \to \infty}
- 求和
\sum_{i=1}^n i
- 积分
\int
,\oint
- 括号自动调整
\left( \frac{a}{b} \right)
详细语法文档可见: 👉 KaTeX 支持的函数列表
🧩 配合 Markdown 使用
很多 Markdown 渲染器(如 Typora、Obsidian、MarkText、VitePress)都支持 KaTeX 语法,但需要开启数学渲染功能。
例如在 Obsidian 中启用:
设置 → 编辑器 → 启用 LaTeX 数学公式
🧪 调试推荐
📚 参考资料
- 官方文档:https://katex.org/
- GitHub 开源仓库:https://github.com/KaTeX/KaTeX
- LaTeX 数学语法参考:https://en.wikibooks.org/wiki/LaTeX/Mathematics
✨ KaTeX 是前端展示数学公式的神器,结合 Markdown 文档系统使用尤为高效!无论是教学、写作还是笔记,都能为你提升专业表达力 💯