VSCode配置Markdown实时预览 VSCode写Markdown文档教程-VSCode-PHP中文网

vscode markdown 预览非实时，需配置 files.autosave 和 markdown.preview.autorefresh 并正确打开预览；ctrl+shift+v 失效多因快捷键被覆盖、文件非 .md 后缀或 markdown.preview.enabled 关闭；未保存内容不触发更新，刷新按钮仅重载 html 不读新内容；公式、mermaid 等需显式启用对应设置；同步滚动、大纲导航等功能需手动开启。

vscode配置markdown实时预览 vscode写markdown文档教程

VSCode 的 Markdown 预览不是“实时”的——它默认只在文件保存后刷新，不监听编辑缓冲区变化；所谓“实时”体验必须靠组合配置达成，核心是 files.autoSave + markdown.preview.autoRefresh + 正确的预览打开方式。

Ctrl+Shift+V 没反应？先查这三个地方

快捷键失效几乎从不因为插件没装，而是被覆盖或前提条件不满足：

markdown.preview.enabled 必须为 true（默认开启，但某些安全策略或远程开发环境可能重置）
当前文件后缀必须是 .md —— .markdown 或无后缀不会触发预览逻辑
键盘映射插件（如 Vim、Emacs 模式）常劫持 Ctrl+Shift+V；临时禁用这些插件再试，或改用命令面板：Ctrl+Shift+P → 输入 Markdown: Open Preview to the Side

为什么改了文字预览不动？不是 bug，是设计

VSCode 预览基于磁盘文件内容，而非编辑器内存缓冲区。未保存的修改不会进入预览流程：

Markdown Converter 1.0.0

使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。

下载

必须按 Ctrl+S（或启用 files.autoSave）才能触发更新
markdown.preview.autoRefresh 控制是否自动响应保存事件，默认 true，但仅对已保存文件生效
若想接近 Typora 式体验：设 files.autoSave 为 onFocusChange 或 afterDelay，再确保 markdown.preview.autoRefresh 开启
右上角的刷新按钮（↻）只重载 HTML，不读新内容——它不解决“没保存”这个根本问题

数学公式、Mermaid 图表、中文标题链接不生效？检查渲染开关

原生预览默认禁用扩展能力，需显式启用：

LaTeX 公式：启用 markdown.math.enabled（VS Code 1.84+），公式块前后必须空行，$$E = mc^2$$ 才有效； $E = mc^2$ 是行内公式，需额外开启 markdown.extension.math.inlineEnabled（如果用了 Markdown All in One）
Mermaid 图表：原生预览不支持；必须装 Mermaid Preview 插件，或用 Markdown Preview Enhanced 并在设置中勾选 Enable Mermaid
中文标题可点击、裸 URL 变链接：启用 markdown.preview.enableExtendedAutolinks 和 markdown.preview.enableScripts（仅限本地可信文档）
样式错乱或白屏：检查 markdown.preview.styles 填的是相对工作区根目录的路径，比如 ["./styles/md-preview.css"]；路径错误无报错，只留空白预览

同步滚动、大纲导航、导出 PDF 这些功能容易被忽略

它们不依赖插件，但必须手动开关键配置，否则写作长文档时效率骤降：

同步滚动需同时开启两个设置：markdown.preview.scrollEditorWithPreview 和 markdown.preview.scrollPreviewWithEditor；只开一个会单向失灵
大纲视图（Outline）是 VS Code 原生功能，按 Ctrl+Shift+P → View: Toggle Outline 即可唤出，无需插件
导出 PDF/HTML 不是内置能力，Markdown Preview Enhanced 是目前最稳的选择；但注意：必须先打开预览窗口，再右键 → Export to PDF，否则路径解析失败
双屏写作最简方案：拖动预览标签页到另一显示器，或右键 → Move to New Window，比任何插件都可靠