Markdown中带编号LaTeX公式的正确写法（适配多工具）

核心原则 #

带编号的LaTeX公式（如align/equation环境）不要用$$包裹，直接在Markdown中写入原生LaTeX环境即可。这是避免Pandoc报错的关键——因为$$会被Pandoc解析为无编号的displaymath环境，嵌套align这类本身就是display级别的环境会触发amsmath的嵌套错误。

各工具适配细节 #

VS Code Markdown #

• 安装Markdown All in One或LaTeX Workshop扩展，这类扩展支持直接渲染未被$$包裹的align/equation等LaTeX公式环境，无需额外包裹就能正常显示带编号的公式。

Jupyter Notebook #

• 确保公式写在Markdown单元格中，直接写入\begin{align}/\begin{equation}环境（无需$$）：

  \begin{equation}
  E = mc^2
  \end{equation}
  

• 切换到Markdown单元格后，Jupyter会正确渲染公式并提供对应的语法高亮，解决之前的高亮问题。

Pandoc转PDF #

• 直接使用原生LaTeX公式环境（无$$包裹），Pandoc会正确识别并传递给LaTeX引擎，不会触发嵌套错误，顺利生成带编号的公式PDF。

完整流程示例 #

1. 在Jupyter的Markdown单元格中写入：

   \begin{align}
   \frac{dy}{dx} &= x^2 + 3 \\
   y &= \frac{1}{3}x^3 + 3x + C
   \end{align}
   

2. 用nbconvert转为Markdown：jupyter nbconvert --to markdown your_notebook.ipynb
3. 用Pandoc转PDF：pandoc your_notebook.md -o output.pdf

这样就能同时适配三款工具，实现公式的正常显示与转换。

内容的提问来源于stack exchange，提问作者PaleNeutron