VSCode_Markdown文件中自动公式编号设置的一种方法

五VV2026-07-20 10:15

VSCode_Markdown文件中自动公式编号设置的一种方法

Markdown Preview Enhanced（MPE，最推荐，实时预览自动编号）

安装插件
扩展市场搜索 Markdown Preview Enhanced 安装。
两步核心配置（开启 MathJax 自动编号）
步骤 1：全局设置切换渲染引擎
Ctrl+Shift+P → 输入 Preferences: Open User Settings (JSON)，添加配置：

json 复制代码

"markdown-preview-enhanced.mathRenderingOption": "MathJax"

步骤 2：开启 AMS 自动编号规则

Ctrl+Shift+P → 输入 Markdown Preview Enhanced: Open Config Script (Global)，打开config.js，替换为：

js 复制代码

({
  katexConfig: {
    "macros": {}
  },
  mathjaxConfig: {
    tex: {
      tags: "ams", // 核心：自动给equation/align环境编号
      inlineMath: [["$", "$"], ["\\(", "\\)"]],
      displayMath: [["$$", "$$"], ["\\[", "\\]"]]
    },
    options: {},
    loader: {}
  },
  mermaidConfig: {
    "startOnLoad": false
  },
})

快速写自动编号公式（两种语法）

① 单行公式（自动递增编号，可加标签引用）

markdown 复制代码

$$
\begin{equation}
E = mc^2 \label{eq:energy}
\end{equation}
$$

文中引用公式\eqref{eq:energy}

KaTeX parse error: Undefined control sequence: \label at position 28: ...tion} E = mc^2 \̲l̲a̲b̲e̲l̲{eq:energy} \en...

文中引用公式\eqref{eq:energy}

预览效果：公式右侧自动生成(1)，插入 / 删除公式后全局序号自动重排。

② 多行对齐公式（每行独立编号）

markdown 复制代码

$$
\begin{align}
a &= x + y \label{eq:line1} \\
b &= x - y \label{eq:line2}
\end{align}
$$

KaTeX parse error: Undefined control sequence: \label at position 51: ... \\ b &= x - y \̲l̲a̲b̲e̲l̲{eq:line2} \end...

\nonumber 取消当前行编号：a &= x+y \nonumber \

\tag{1.2} 手动强制自定义编号