数学公式

公式会先被替换成占位符，再交给 KaTeX 渲染，所以 Markdown 不会把反斜杠搞乱。 本页把支持的几种写法都列一遍。

行内公式

质能方程 $E=mc^2$；括号写法 $a^2+b^2=c^2$； AsciiDoc 风格的 $x_{1,2} = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$。

块级公式

$$\int_0^\infty e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}$$

化学式

mhchem 扩展已加载，所以 $\ce{H2O}$ 这类化学式也能渲染。

含中文的公式会被跳过

下面两处故意不渲染——公式里出现了中文或全角字符，规则见下一节：

• 金额：这件商品价格是 $100 到 $200 之间，不该被当成公式。
• 有意为之：$能量 = 质量 \times c^2$ 会被原样保留在正文里。

为什么要跳过

正文里出现货币符号是很常见的，preprocessMath 用一个中文字符正则做判断， 只要捕获到的内容里含中文（或全角符号），就原样返回、不交给 KaTeX。

渲染失败不会中断构建

KaTeX 用了 throwOnError: false，写坏的公式只会在页面上留下红色报错，不会让构建挂掉。