如何让Visual Studio Code不对两个分隔符间的文本进行格式化？

算力阿峰

2026-5-19

解决VS Code格式化HTML时跳过MathJax LaTeX代码块的问题

当然可以搞定这个麻烦！VS Code的格式化工具（不管是内置的HTML formatter还是常用的Prettier）都支持通过特定注释或配置来跳过指定区域的内容，完美适配你的MathJax LaTeX场景。下面给你两种实用的方案：

方案一：用注释标记跳过区域（最灵活）

这是最直接的方式，针对单个LaTeX代码块设置跳过，不会影响其他内容的格式化。

如果用Prettier作为格式化工具

在需要保护的LaTeX代码块前后添加这对注释：

<!-- prettier-ignore-start -->
<div class="math-display">
    $$
    \sum_{n=1}^\infty \frac{1}{n^2} = \frac{\pi^2}{6}
    $$
</div>
<!-- prettier-ignore-end -->

Prettier会自动识别这两个注释，完全跳过中间内容的格式化。

如果用VS Code内置的HTML格式化工具

换成这对注释即可：

<!-- format: off -->
<span class="math-inline">
    \( f(x) = x^2 + 3x - 5 \)
</span>
<!-- format: on -->

内置工具看到format: off就会暂停格式化，直到遇到format: on恢复。

方案二：全局配置（针对批量场景）

如果你有大量MathJax代码块，也可以通过VS Code的设置文件统一配置：

打开VS Code的设置面板（快捷键Ctrl+,），点击右上角的打开设置(JSON)按钮。
添加以下配置（以Prettier为例）：

"[html]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
},
"prettier.overrides": [
    {
        "files": "*.html",
        "options": {
            // 关闭嵌入语言的格式化，避免LaTeX被乱改
            "embeddedLanguageFormatting": "off"
        }
    }
]

这个配置会让Prettier在格式化HTML时，不对嵌入的其他语言（比如你的LaTeX）进行处理。