Ctrl+Shift+V没反应是因为触发条件未满足：文件后缀必须为.md或.markdown、右下角语言模式须设为Markdown、快捷键可能被Vim/Emacs插件或中文输入法劫持。
Ctrl+Shift+V 按了没反应？先看这三件事
不是快捷键坏了，是触发条件没满足。VSCode 的 markdown.showPreview 命令只在特定上下文生效：
- 当前编辑器标签页必须已打开一个
.md或.markdown文件（.txt或无后缀文件不行） - 右下角状态栏语言模式必须显示 Markdown；如果显示
Plain Text，点它 → 选Markdown - 快捷键可能被插件劫持：Vim/Emacs 插件、终端扩展、甚至某些中文输入法会吞掉
Ctrl+Shift+V；用Ctrl+Shift+P搜Markdown: Open Preview to the Side直接运行，能绕过所有冲突
预览内容不更新？90% 是因为没保存
VSCode 内置预览读的是磁盘文件，不是编辑器缓冲区。改完不按 Ctrl+S，它根本不知道你动过什么：
-
markdown.preview.autoRefresh默认为true，但它只对**已保存的文件**生效 - 想接近“边写边看”，必须开自动保存：
files.autoSave设为onFocusChange或afterDelay - 预览窗口右上角的
↻刷新按钮只重载 HTML，不读新内容；未保存时点它无效 - 某些插件（如 Markdown Preview Enhanced）会接管刷新逻辑，导致原生行为异常；排查时建议先禁用所有第三方 Markdown 插件
公式、Mermaid、图片全不显示？配置开关没开
原生预览默认禁用扩展语法，不是不支持，是关着的：
- 数学公式：设
markdown.math.enabled为true，文档中用$$E=mc^2$$或\(E=mc^2\) - Mermaid 图表：设
markdown.mermaid.enabled为true，代码块必须声明语言：```mermaid，不能只写```或~~~mermaid - 本地图片路径按**工作区根目录**解析，不是当前
.md所在目录；中的./指的是工作区根 - 若需执行脚本（如 KaTeX 渲染），还得设
markdown.preview.enableScripts为true，否则公式和图表静默失败
导出 PDF 或自定义样式失败？别指望内置预览
VSCode 自带预览不提供导出功能，也不支持自定义 CSS：
- 右键“另存为”得到的是无样式的纯 HTML 快照
- 导出 PDF 必须装插件，如
Markdown PDF；Linux 下常因缺libxss1、libglib2.0-0报Failed to launch browser - 想加样式？用
markdown.preview.styles填 CSS 路径，但注意：路径是相对于工作区根的，填错就静默失败 - 中文标题锚点跳转失效？原生生成逻辑对中文/标点兼容差；装
Markdown All in One并启用githubCompatibilityMode可解决
真正卡住人的从来不是“怎么打开预览”，而是“为什么我改了它不认”——核心就两条：文件必须保存，路径必须对准工作区根。其他所有问题，基本都绕不开这两点。
