使用 VSCode 写 Markdown 时，如果需要嵌入数学公式，通常是写论文、笔记或技术文档的场景。我刚接触时也遇到问题——预览里全是源代码，比如 $\frac{1}{2}$ 显示成文本，而不是分式。其实 VSCode 本身不直接支持 LaTeX 渲染，需要搭配扩展来完成。下面是我的配置思路和踩过的坑，供参考。
VSCode 内置的 Markdown 预览默认不支持 LaTeX 公式渲染。如果你在预览中看到的是原始 LaTeX 代码如 `$\frac{1}{2}$` 而非渲染后的公式，说明当前环境缺少公式支持插件。常见的判断方法是检查预览页面是否显示数学符号，或者查看扩展列表中是否已安装 markdown 数学相关扩展。
推荐安装 Markdown+Math 或 Markdown Preview Enhanced 扩展。安装后，需在设置中启用公式渲染：对于 Markdown+Math，在设置搜索 `markdown-math.enabled` 并勾选；对于 Markdown Preview Enhanced，在扩展设置中确认 `enableMath` 为 true。重启 VSCode 或重新打开预览即可生效。
先判断是否真的缺少支持
VSCode 内置的 Markdown 预览默认不支持 LaTeX 公式渲染。如果你在预览中看到的是原始 LaTeX 代码如 $\frac{1}{2}$ 而非渲染后的公式，说明当前环境缺少公式支持插件。常见的判断方法是检查预览页面是否显示数学符号，或者查看扩展列表中是否已安装 markdown 数学相关扩展。这个判断步骤很简单：打开一个带公式的 .md 文件，按 Ctrl+Shift+V 看预览，如果公式没渲染，再回头看看扩展栏里有没有装过类似“Markdown+Math”的插件。如果装了但没生效，通常是配置或冲突问题，下面会讲。
推荐扩展和配置方式
推荐安装 Markdown+Math 或 Markdown Preview Enhanced 扩展。安装后，需在设置中启用公式渲染：对于 Markdown+Math，在设置搜索 markdown-math.enabled 并勾选；对于 Markdown Preview Enhanced，在扩展设置中确认 enableMath 为 true。重启 VSCode 或重新打开预览即可生效。我习惯用 Markdown+Math，因为它轻量、只干一件事，不太和别的预览增强插件打架。Markdown Preview Enhanced 功能更多，但如果只是需要公式，前者更省心。注意：设置分用户设置和工作区设置，如果工作区有 .vscode/settings.json，优先检查它是否覆盖了全局配置。例如，如果你在项目里设置了 "markdown-math.enabled": false，那即使全局勾选了也没用。
验证配置是否生效
安装扩展并配置后，打开一个包含 LaTeX 公式的 Markdown 文件，按 Ctrl+Shift+V 打开预览。如果公式正确显示（如分式、积分号等），则配置成功。若仍显示原始代码，可检查预览控制台（右键预览区域 -> 检查元素，查看 Console 是否有错误信息）。这一步很实用，因为常见的问题比如 KaTeX 加载失败，会在控制台输出 404 或语法错误。我遇到过插件版本不匹配导致公式不渲染，控制台提示“KaTeX not found”，重装扩展就解决了。另外，如果预览是空白的，可能是扩展冲突，可以临时禁用其他 Markdown 扩展，只保留一个公式渲染扩展再试。
注意扩展的语法限制和冲突风险
注意，部分扩展仅支持特定的 LaTeX 语法。例如，Markdown+Math 基于 KaTeX，不支持某些复杂环境如 \begin{align}。如果遇到公式不渲染，应检查 LaTeX 源码是否符合 KaTeX 或 MathJax 的语法规范。此外，扩展可能与其他 Markdown 预览增强插件冲突，建议只启用一个公式渲染扩展。我踩过的一个坑：同时装了 Markdown Preview Enhanced 和 Markdown+Math，结果预览变成了两个都加载，公式显示混乱。后来只保留一个，问题就消失了。如果你的公式包含矩阵、多行对齐等复杂结构，可以先查一下 KaTeX 支持列表，或者换用基于 MathJax 的扩展（比如 Markdown Preview Enhanced 可以选渲染器）。但 MathJax 加载慢一些，看个人取舍。
一个容易被忽略的问题：分隔符
一个常见的坑是忘记在 Markdown 文件中使用正确的公式分隔符。VSCode 的公式扩展通常要求使用美元符号 $ 或双美元符号 $$ 包裹公式，而不是其他语法。比如使用 \( ... \) 可能不被部分扩展识别。所以我写公式时统一用 $...$ 行内，$$...$$ 块级，基本不会出错。如果预览还是不行，检查一下公式里有没有多余的空格或错误的转义。比如 $ rac{1}{2}$ 里的反斜杠不能少，否则会显示为纯文本。
总结一下检查清单
- 确认已安装且仅启用一个公式扩展（如 Markdown+Math）。
- 在设置中启用对应的选项（如
markdown-math.enabled）。 - 检查工作区设置未覆盖全局配置。
- 使用正确的分隔符
$或$$。 - 验证时查看预览控制台是否有错误。
- 如果公式复杂，确认扩展支持的 LaTeX 子集（KaTeX 不支持
\begin{align}，可改用\begin{aligned}）。
按照这个流程，大部分情况都能搞定。如果还是不行，可以临时新建一个 Markdown 文件，只写最简单的公式（比如 $a+b=c$）测试，排除文件本身的问题。扩展的设置通常不需要重启 VSCode，重新打开预览就生效，但如果改了设置没反应，重启一下 VSCode 也不费事。