vs code 自带 markdown 预览功能，但需注意快捷键（ctrl+shift+v）、同步滚动、锁定预览、样式限制及导出依赖插件等关键细节。
VS Code 自带 Markdown 预览功能，无需插件就能实时查看渲染效果，但默认行为和常见编辑习惯之间有几个关键差异点，容易导致预览不更新、样式错乱或导出失败。
怎么打开实时预览窗口
在打开的 .md 文件中，按 Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（macOS）即可唤出右侧预览窗；也可右键编辑区 → 选择「Open Preview to the Side」。这个预览是只读、响应式、支持锚点跳转的，但不会自动同步滚动——除非你开启「Sync Scrolling」（点击预览窗口右上角三个点 → 勾选）。
常见错误现象：Ctrl+V 被误按成粘贴快捷键，结果没反应；或者用 Ctrl+K V（旧版快捷键），新版已弃用。
- 预览窗口不随编辑内容变化？检查是否误点了「Lock Preview to Current Document」（锁图标），锁住后切换文件也不会更新预览
- 想固定预览位置？拖动预览标签页到右侧/底部即可，VS Code 会记住布局
- 不希望每次手动开？可在设置中搜索
markdown.preview.autoShowPreview，设为true
为什么预览里中文标题没样式、链接点不开
这是 VS Code 默认预览器禁用了部分 HTML 渲染能力：它不执行脚本、不加载远程 CSS、对内联样式支持有限，且默认关闭 markdown.preview.enableScripts 和 markdown.preview.enableExtendedAutolinks。
典型表现：## 中文标题 显示为普通文本；[百度](https://baidu.com) 渲染成纯文本而非可点击链接；表格边框消失。
- 启用基础交互：打开设置 → 搜索
enableScripts→ 勾选markdown.preview.enableScripts（仅限本地可信文档） - 修复链接点击：确保启用了
markdown.preview.enableExtendedAutolinks，否则形如https://xxx的裸 URL 不会被自动转为链接 - 样式缺失？VS Code 预览用的是内置样式表，不读取你写的
<style></style>或外部 CSS，也不支持class属性
如何导出为 HTML 或 PDF
VS Code 不内置导出功能，必须借助插件，但选错插件会导致编码错误、图片路径失效或样式全丢。
推荐组合：Markdown All in One（提升编写效率） + Markdown Preview Enhanced（导出能力强）。后者支持右键 → 「Export to HTML」或「Export to PDF」，且能正确解析相对路径图片、数学公式（需启用 mathjax）和 Mermaid 流程图。
- 导出 HTML 后图片显示为红叉？检查图片路径是否为相对路径（如
./img/logo.png），绝对路径或网络地址可能被拦截 - PDF 导出空白？确认系统已安装
Pandoc或Chrome（Markdown Preview Enhanced优先调用本地 Chrome） - 不想装插件？可用命令行临时导出：
pandoc input.md -o output.html，但需自行处理 CSS 和资源路径
真正麻烦的不是怎么打开预览，而是当文档含 Mermaid、Front Matter、自定义 CSS 或跨平台协作时，VS Code 默认预览和插件行为不一致——比如 Markdown Preview Enhanced 支持 ---\ntitle: xxx\n---，但原生预览直接忽略整段。这些边界情况，得靠具体需求去试配，而不是指望一个开关搞定所有。
