Ctrl+Shift+V没反应是因为文件后缀非.md、语言模式未设为Markdown或快捷键被Vim/输入法等劫持；代码块高亮需用`python等明确language ID；公式和Mermaid须手动启用对应设置并重启预览窗口。
VSCode 里打开 Markdown 文档，Ctrl+Shift+V 没反应？
不是插件没装，是基础条件没满足。VSCode 内置预览只认 .md 后缀、且当前语言模式必须是 Markdown（右下角状态栏显示）。如果显示 Plain Text 或 HTML，按 Ctrl+Shift+P → 输入 Change Language Mode → 选 Markdown 即可。
快捷键被劫持也很常见：Vim 插件、输入法、终端扩展都可能吞掉 Ctrl+Shift+V。直接用命令面板搜 Markdown: Open Preview to the Side，能绕过所有冲突。
代码块语法高亮不生效？检查 language ID 和文件路径
VSCode 预览对代码块的识别依赖准确的 language ID。写法必须是：
```python
def hello():
return "world"
```
而不是 ```py 或 ``` 空着——后者会被当纯文本处理，无高亮。
另外，如果你的文档在子目录（如 docs/guide.md），而代码示例引用了同级 ./src/main.py，预览不会加载该文件内容；它只渲染 Markdown 里的内联代码块，不执行或读取外部文件。
数学公式、Mermaid 图表离线不渲染？手动开开关
这些功能默认关闭，哪怕完全离线也要显式启用：
-
markdown.math.enabled设为true才支持$$E=mc^2$$ -
markdown.mermaid.enabled设为true才解析 Mermaid 代码块（注意必须声明语言：```mermaid） - 改完设置后，**必须重启预览窗口**（关掉再按
Ctrl+Shift+V），仅刷新无效
不需要网络、不调 API、不连 CDN——全是本地解析，但开关得自己拧开。
导出 HTML/PDF 必须装扩展，且 Linux 下容易卡在依赖
内置预览右键“另存为”只能存无样式的裸 HTML；导出 PDF 完全不支持。可靠方案是装 yzane.markdown-pdf 或 shd101wyy.markdown-preview-enhanced 的 .vsix 离线包。
Linux 用户特别注意：markdown-pdf 启动 Chromium 渲染时，若系统缺 libxss1 或 libglib2.0-0，会静默失败，控制台只报 Failed to launch browser。装之前先跑：
sudo apt-get install libxss1 libglib2.0-0
否则拖进 VSCode 安装成功，实际导出时却卡死不动。
真正麻烦的从来不是“怎么点开预览”，而是那些默认关掉、不报错、也不提示的开关和路径规则——它们藏在设置里，又不写在文档开头。
