VS Code 原生支持 Markdown 高效写作，只需配置两项关键设置：启用双向滚动同步（scrollEditorWithPreview 和 scrollPreviewWithEditor）及开启 KaTeX 数学公式渲染（math.enabled），再配合 Outline 导航与 mdpdf 导出 PDF 即可。
VS Code 默认就能写 Markdown，但要获得接近专业写作的体验——比如实时同步滚动、数学公式、目录导航、导出 PDF——得手动调几个关键配置，而不是装一堆插件。
启用原生预览并解决滚动不同步问题
VS Code 内置的 Markdown: Preview 命令（Ctrl+Shift+V）能打开预览，但默认不开启「滚动同步」。常见现象是：编辑区往下滚，预览页卡在顶部，反之亦然。
- 按
Ctrl+Shift+P打开命令面板，输入并运行Preferences: Open Settings (JSON) - 在
settings.json中添加："markdown.preview.scrollEditorWithPreview": true,
"markdown.preview.scrollPreviewWithEditor": true - 这两个选项必须同时开启，缺一不可；仅开一个会导致单向同步失效
让 LaTeX 数学公式正常渲染
原生预览默认不解析 $...$ 或 $$...$$ 中的数学表达式，会原样显示为文本。这不是插件缺失问题，而是 KaTeX 渲染未启用。
- 在
settings.json中加入："markdown.math.enabled": true
- 确保你用的是 VS Code 1.84+ 版本（旧版该配置项无效）
- 公式语法必须严格：行内用单美元符
$E = mc^2$，独立块用双美元符$$\int_0^\infty e^{-x}dx = 1$$；混用反引号或中文符号会直接失效
添加右侧大纲（Outline）和一键导出 PDF
大纲视图不是 Markdown 插件专属功能，而是 VS Code 的原生侧边栏能力；PDF 导出则依赖外部工具链，不能只靠插件点一下就完事。
- 打开命令面板 → 运行
View: Toggle Outline，即可唤出右侧标题层级导航（基于#~######自动生成） - 导出 PDF 需先安装
mdpdfCLI：npm install -g mdpdf
，再在设置中指定路径："mdpdf.executablePath": "mdpdf"
- 注意：如果系统 PATH 没包含 npm 全局 bin 目录（如 Windows 的
%USERPROFILE%\AppData\Roaming\npm），mdpdf会报错command not found
真正影响写作流的是同步滚动和数学公式这两项——其他功能大多可有可无。很多人反复重装插件，其实只是没打开那两个布尔值配置。
