Markdown 语法

Markdown 里怎么写数学公式？
用 $ 和 $$ 写 LaTeX

你想在 Markdown 里写数学，一个行内的符号（比如一个变量），或者一整条公式（比如一个积分）。标准 Markdown 没有自己的数学语法，但几乎每个支持数学的工具都用同一套约定：美元符号包住的 LaTeX。

这里讲语法、那个最容易踩的美元符号坑，以及它怎么渲染。

行内公式和块级公式

每边用一个美元符号包 LaTeX，得到句子里的行内公式：

质能方程是 $E = mc^2$。

每边用两个美元符号，得到一个块级：独占几行、居中的公式。

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

美元符号之间的部分是 LaTeX 数学，由 KaTeX 这样的库渲染。它是扩展、不是标准 Markdown，所以在支持它的工具里能用（Obsidian、很多编辑器、部分 GitHub 视图），在不支持的工具里显示成纯文本。

用 $ 写数学，最明显的风险就是钱。如果一个工具把每个美元符号都当数学，"它花了 $5 或 $10" 这句话就会把中间变成公式。为避免这个，行内公式的规则很严：

所以 $E=mc^2$ 渲染成数学，而一句关于 5 块或 10 块钱的话保持纯文本。如果你的数学不渲染，先看看美元符号内侧是不是多了个空格。

NoteLoom 用 KaTeX 渲染 $...$ 和 $$...$$。编辑时有个好处：在编辑视图里，当光标落在有公式的那行时会显示原始 LaTeX 方便你改，移开光标就渲染回公式。阅读视图直接显示渲染后的数学。

它覆盖的是数学模式 LaTeX：希腊字母、分数、积分、求和、矩阵和多数符号。它不是完整的 LaTeX 文档引擎，渲染的是数学，而你的文件保持纯 .md、里面的 LaTeX 可读。

Markdown 里怎么写数学公式？

标准 Markdown 自己没有数学，但多数支持数学的工具用美元符号包 LaTeX：每边一个美元符号是行内公式，每边两个是块级公式。像 KaTeX 这样的库把 LaTeX 变成渲染后的公式。

数学是标准 Markdown 吗？

不是，是扩展。美元符号包 LaTeX 的约定被广泛支持，在 Obsidian、很多编辑器和部分 GitHub 场景里都行，但一个不支持数学的纯 CommonMark 渲染器只会把美元符号和 LaTeX 显示成文本。

为什么价格变成了公式，或者我的公式为什么不渲染？

美元符号的规则故意很严，免得把钱当成公式。美元符号得紧贴公式里的非空白，闭合的美元符号后面不能紧跟数字。所以行内公式会渲染，而用美元符号写的“5 或 10”这种价格句会保持纯文本。如果你的公式不渲染，检查一下美元符号内侧有没有多余的空格。

一个美元符号和两个有什么区别？

每边一个是行内公式，待在句子的行文里。每边两个是块级：一段独占几行、居中的公式，上下留空。

NoteLoom 渲染 LaTeX 数学吗？

渲染，用 KaTeX。编辑视图里，当光标落在有公式的那行时会显示 LaTeX 源码方便你改，移开光标就渲染回公式。阅读视图直接显示渲染后的公式。

能用完整的 LaTeX 吗？

它是 KaTeX 渲染的数学模式 LaTeX，覆盖常见的东西：希腊字母、分数、积分、求和、矩阵和多数符号。它不是一个完整的 LaTeX 文档引擎，渲染的是数学、不是整篇 LaTeX 论文。

用 Chrome / Edge / Arc 打开 NoteLoom，打开一个 .md 文件，在美元符号里写 LaTeX，编辑和阅读视图用 KaTeX 渲染它、直接存回文件。不用装、不用账号。