Markdown 中的数学公式:用 $、$$、\( \) 和 \[ \] 书写公式

笔记、作业、实验报告和 AI 的回答中常常有公式。在 Markdown 文件里,它们用 LaTeX 书写,例如 $E = mc^2$。纯文本查看器会把它显示为原始代码。能排版数学公式的阅读器则会显示真正的公式。

本指南说明怎样书写 Markdown 数学公式、该用哪些定界符,以及哪里容易出错。

行内公式和独立公式

公式有两种:

The famous formula is $E = mc^2$ and it stays in the sentence.

$$\int_0^1 x\,dx = \tfrac{1}{2}$$

四种定界符

定界符就是公式两边的标记。你会遇到四种:

定界符类型示例
$…$行内$a^2 + b^2 = c^2$
$$…$$独立$$a^2 + b^2 = c^2$$
\(…\)行内\(a^2 + b^2 = c^2\)
\[…\]独立\[a^2 + b^2 = c^2\]

这些只是约定。数学公式不属于 CommonMark 或 GitHub Flavored Markdown 规范,因此各个工具自行决定读取什么。

```math
\sum_{k=1}^n k = \frac{n(n+1)}{2}
```

如果拿不准,请使用 $…$ 和 $$…$$。它们的支持范围最广。

你会用到的 LaTeX 片段

复制这些内容,然后改动其中的字母。

你想要你写成
分数\frac{a}{b}
乘方x^2,超过一个字符时用 x^{10}
下标x_1,以及 x_{max}
平方根\sqrt{x},立方根用 \sqrt[3]{x}
希腊字母\alpha \beta \pi \Delta
求和\sum_{i=1}^{n} i
积分\int_0^1 x\,dx
公式中的文字\text{speed}

一个矩阵:

$$
\begin{pmatrix} a & b \\ c & d \end{pmatrix}
$$

多行以等号对齐:

$$
\begin{aligned}
x + y &= 5 \\
x - y &= 1
\end{aligned}
$$

& 标出各行对齐的位置。\\ 开始新的一行。

用 \ce{} 书写化学式

化学式使用 \ce{}。它来自 mhchem 包。把它放在公式里面:

$\ce{H2O}$ and $\ce{CrO4^2-}$

$$\ce{CH4 + 2O2 -> CO2 + 2H2O}$$

$$\ce{A <=> B}$$

数字会变成下标,^ 用来设置电荷,-> 画出箭头,<=> 画出平衡箭头。该工具必须支持 mhchem,并非所有工具都支持。

常见错误

把美元符号用作货币。 同一行里的两个价格可能看起来像公式:

It costs $5 and the other costs $10.

读取单个美元符号的工具可能会把 5 and the other costs 当作数学公式。请在每个表示货币的美元符号前加反斜杠来转义:

It costs \$5 and the other costs \$10.

在 GitHub 上,你也可以写成 <span>$</span>5。在 GitHub 的公式内部,反斜杠有效:$\sqrt{\$4}$。

美元符号内侧紧挨着空格。 请写 $x$,而不是 $ x $。当起始的 $ 后面跟着空格时,有些工具不会读取公式。让公式紧凑可以避免这个问题。

独立公式内部有空行。 空行会结束一个段落,许多工具随后就会停止读取公式。请让整个 $$ … $$ 块保持连续的行,中间不要有空行。

$$ 公式与文字粘在一起。 对于独立公式,请把 $$ 单独放在一行,前后各留一个空行。

阅读 Markdown 中的数学公式

PilcrowMD 在你的设备上排版公式。它不使用互联网,也不使用隐藏的网页。

要修正公式,请切换到编辑器,修改 LaTeX,然后切换回来查看结果。

PilcrowMD Mac 版(测试版)

常见问题

ChatGPT、Claude 或 Gemini 给出的数学公式能在 Markdown 中使用吗? 能,只要回答被保存为 Markdown,并且你的阅读器认识它所用的定界符。许多助手写的是 \( \) 和 \[ \]。如果你的阅读器只认识美元符号,请把它们替换成 $…$ 和 $$…$$。

$ 和 $$ 有什么区别? 两边各一个美元符号,得到的是行内公式,位于句子中。两边各两个美元符号,得到的是独立公式,单独占一行。

为什么我的公式显示为纯文本? 最常见的原因是:阅读器不支持数学公式,定界符是阅读器不认识的,$ 内侧紧挨着空格,或独立公式内部有空行。请按这个顺序逐一检查。

Mac 上同样可用: PilcrowMD Mac 版(测试版)