需启用KaTeX支持、安装markdown All in One扩展、配置settings.json宏定义，并用测试用例验证：行内公式$E=mc^2$和块级公式$$int_0^infty e^{-x}dx = 1$$应清晰渲染。
如果您在vscode中编写Markdown文件并希望直接渲染数学公式，但发现公式未正确显示或出现语法错误，则可能是由于内置的Markdown预览未启用KaTeX支持或配置不完整。以下是实现此功能的具体操作步骤：
本文运行环境：macBook air，macOS Sequoia。
一、启用Markdown预览的KaTeX支持
VSCode默认的Markdown预览使用简单html渲染，不原生支持LaTeX数学公式；需通过设置启用KaTeX解析引擎，使行内公式（如 $E=mc^2$）和块级公式（如 $$int_0^infty e^{-x}dx = 1$$）被正确识别与排版。
1、打开VSCode，按下 Cmd + , 进入设置界面。
2、在右上角搜索框中输入 markdown.preview.math。
3、勾选 Markdown > Preview: Math
4、关闭设置页，重新打开任意 .md 文件并触发预览（Cmd + K V）。
二、安装支持KaTeX的Markdown扩展
官方内置预览对复杂公式兼容性有限；安装第三方扩展可增强KaTeX版本、提供实时高亮与错误提示，并支持更多LaTeX宏包。
1、点击左侧活动栏中的扩展图标（或按 Cmd + Shift + X）。
2、在扩展市场搜索栏输入 Markdown All in One。
3、找到作者为 Yu Zhang 的扩展，点击“安装”。
4、安装完成后，重启VSCode，打开一个含数学公式的Markdown文件，确认公式区域出现绿色波浪下划线提示（表示KaTeX语法已激活）。
三、手动配置settings.json启用高级KaTeX选项
部分公式（如带标签的多行对齐环境 begin{align}…end{align}）需通过json配置显式开启KaTeX扩展能力，包括自动编号、字体缩放与自定义宏定义。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Preferences: Open Settings (JSON)。
3、在 settings.json 的根对象内添加如下键值对：
“markdown.extension.katex.macros”: {“\RR”: “\mathbb{R}”, “\abs”: [“\left|#1\right|”, 1]}
4、保存文件，重新加载窗口（Cmd + Shift + P → Developer: Reload window）。
四、验证公式渲染效果的最小测试用例
创建一个空白 .md 文件，粘贴标准测试内容，可快速确认KaTeX是否生效，避免因空格、换行或转义字符导致的静默失败。
1、新建 test.md，写入以下内容：
行内公式：$\lim_{x \to 0} \frac{\sin x}{x} = 1$；块级公式：
$$n\begin{aligned}n\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\n\nabla \times \mathbf{B} &= \mu_0 \mathbf{J} + \mu_0 \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t}n\end{aligned}n$$
2、按下 Cmd + K V 启动预览。
3、检查公式是否清晰渲染，无乱码、无未定义符号（如 ? 或原始LaTeX代码残留）。