VS Code 写 Markdown 默认预览 + Markdown All in One 就够用：内置预览支持基础渲染和公式（需开启 markdown.extension.math.enabled），All in One 专注编辑增强且无性能开销；常见问题如预览空白、公式不渲染、图片路径错乱、PDF 导出失真，均可通过正确配置和插件组合解决。
VS Code 写 Markdown 不需要堆插件，真正影响体验的只有两个环节：预览是否稳定、写作是否顺手。其他功能都是锦上添花，装错反而拖慢启动和渲染。
为什么默认预览 + Markdown All in One 就够用
VS Code 自带的 markdown.preview.enabled 已支持基础渲染（标题、列表、代码块、表格、$$ 行间公式），只要在设置中开启 markdown.extension.math.enabled，数学公式就能正常显示。再配上 Markdown All in One，它不接管预览，只增强编辑——补全标题、生成目录、快捷插入链接/图片、自动对齐表格，所有操作都在源码层完成，没有额外 Webview 开销。
常见错误现象：Ctrl+Shift+V 按下后预览空白或报错 Cannot read property 'webview' of undefined，大概率是同时启用了 Markdown Preview Enhanced 或禁用了内置预览但没重启窗口。
- 确保
markdown.preview.enabled为true（不要手动设为false） - 卸载或禁用
Markdown Preview Enhanced，除非你明确需要 Mermaid 或 PlantUML - 安装
Markdown All in One后，用Ctrl+Shift+P→Markdown: Toggle Preview触发预览，比快捷键更可靠
数学公式不渲染？先查这三个配置项
公式失效不是插件问题，而是配置链断裂。VS Code 的公式支持依赖三层：语法识别 → 渲染引擎启用 → HTML 输出允许执行脚本。任意一层断掉，$$E = mc^2$$ 就只会当普通文本显示。
必须检查的设置：
-
markdown.extension.math.enabled：必须为true（Markdown All in One提供） -
markdown.preview.enableScripts：必须为true（否则 MathJax 不加载） -
markdown.preview.breakOnSingleNewLine：设为false，避免换行符干扰公式解析
如果仍不生效，临时在 settings.json 中加一行："markdown.preview.preferredMdEngine": "github"，强制走 GitHub 风格解析器，兼容性更好。
本地图片路径错乱、预览空白怎么办
VS Code 默认按当前打开的文件夹根路径解析 ，但如果你是从子目录打开 .md 文件，或用了工作区多根，路径就容易错位。预览显示空白，90% 是路径未被正确解析，而非插件没装好。
使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索，适用于需要快速、高效搜索大量 Markdown 文章的场景。
推荐做法：
- 统一把图片放在
./assets/目录下（与 .md 文件同级） - 引用时写完整相对路径：
，开头的./显式声明当前目录，VS Code 和静态站点生成器（Hugo/Jekyll）都认 - 装
Paste Image插件时，务必关闭pasteImage.insertPattern的绝对路径模板，改用 - 别依赖
Markdown Preview Enhanced的“拖拽插入”，它默认存到./images/且写相对路径不带./，迁仓库后必崩
导出 PDF 格式错乱？绕开浏览器打印陷阱
用 Ctrl+P → Export to PDF 或右键“Print to PDF”，本质是调用 Chromium 打印模块，会忽略自定义字体、CSS 行高、代码块滚动条等样式，导出结果常有截断、缩放失真、中文字体缺失等问题。
真正可用的方案只有两个：
- 用
Markdown PDF插件：它基于wkhtmltopdf，可读取 VS Code 当前预览样式（包括你设的markdown.preview.fontSize和markdown.styles），导出保真度高 - 用
Markdown Preview Enhanced的导出功能（仅当已启用它）：点击预览右上角齿轮 →Export to PDF，它会注入 MathJax 和 Mermaid 支持，但首次导出需等资源加载完成
注意：Markdown PDF 需要系统已安装 wkhtmltopdf，macOS 上用 brew install wkhtmltopdf，Windows 用户直接下载 exe 并加进 PATH —— 这步最容易被跳过，导致导出按钮灰掉。
最常被忽略的点：预览样式和导出样式不是一回事。你在 settings.json 里调的 markdown.preview.fontSize 只影响右侧窗格，对 PDF 导出无效；要改导出效果，得配 markdown.styles 或插件专属 CSS 入口。写完别急着导，先右键预览 → “Open Preview in Browser”，在浏览器里确认样式无误再导出。
