VSCode原生Markdown体验需配置三项：语言模式识别（右下角显示Markdown）、同步滚动（双开scrollEditorWithPreview和scrollPreviewWithEditor）、数学公式与Mermaid启用（math.enabled和preview.mermaid设为true），缺一不可。
VSCode 写 Markdown 本身不依赖插件就能跑起来，但“沉浸式”不是开个预览窗就完事——它卡在三个地方：语言模式没识别、同步滚动关着、数学公式和 Mermaid 默认禁用。这些配置项一开，原生体验就足够顺手。
Ctrl+Shift+V 按了没反应？先看右下角是不是 Markdown
快捷键失效，90% 是 VSCode 根本没把当前文件当 Markdown 处理。它只认 .md 或 .markdown 后缀，且必须激活对应语言模式。
- 检查右下角状态栏：必须显示
Markdown，不是Plain Text或空白 - 新建的无名文件（比如粘贴内容后直接编辑）不会自动识别，务必先保存为
xxx.md - 手动设置语言模式：
Ctrl+K M→ 输入markdown→ 回车 - 远程开发（SSH/WSL）下，确认远程端也加载了 Markdown 语言支持（精简镜像可能删掉）
预览窗口不动、不同步、点标题不跳转？开这两个布尔值
默认预览是静态快照，不是活的视图。编辑器滚了，预览卡住，是因为双向滚动开关全关着。
pdf文档转markdown
下载
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
- 在
settings.json中加这两行（缺一不可）："markdown.preview.scrollEditorWithPreview": true"markdown.preview.scrollPreviewWithEditor": true - 仅开一个会导致单向同步失效，比如编辑能带预览，但预览点击标题却跳不回源码
- 双击预览区任意位置，光标会自动跳转到对应源码行——这个功能依赖同步开启才生效
公式和 Mermaid 不渲染？不是插件问题，是配置项被默认关了
VS Code ≥1.84 原生支持 KaTeX，≥1.86 原生支持 Mermaid，但都默认禁用。不是你写错了语法，是引擎根本没启动。
- 公式启用：
"markdown.math.enabled": true；公式块前后必须空行，$$E = mc^2$$紧贴文字会失败 - Mermaid 启用：
"markdown.preview.mermaid": true；语法必须是完整代码块：```mermaid开头，不能少反引号 - 别往文档里加
<script>或手动引入 KaTeX CDN——预览沙盒环境会直接忽略 - 启用后需重启预览窗口（关掉再
Ctrl+Shift+V）才生效
中文导出 PDF 成方块？原生预览根本不嵌字体
浏览器打印预览页生成的 PDF，用的是系统默认英文字体，压根不含中文字形。这不是权限或路径问题，是能力缺失。
- VSCode 原生预览没有字体嵌入机制，导出 PDF 必须走外部工具链
- 推荐装
markdown-pdf扩展（注意不是同名旧版），按Ctrl+Shift+P→Markdown PDF: Export (pdf) - 它底层调用 Puppeteer，能读取你自定义的
markdown.css，中文字体正常显示 - 如果坚持用浏览器打印，请先在预览页右键 →
Open Preview in Browser，再手动指定中文字体（不可靠，不推荐）
最常被忽略的其实是语言模式识别和同步滚动这两个基础开关——很多人折腾插件、重装扩展，最后发现只是 settings.json 里漏了两行 true。
