VS Code Markdown预览不实时刷新的根源在于其依赖保存事件而非实时监听，且受配置错误、扩展冲突、文件系统限制及渲染机制（如KaTeX/Mermaid异步加载）共同影响。
Ctrl+Shift+M 没反应、预览不同步、公式不渲染——不是 Atom 不行，是默认插件太老，且配置没对。
Ctrl+Shift+M 快捷键失效的 4 个真实原因
这不是快捷键坏了，而是触发条件没满足：
- 文件未保存：临时文件（如
untitled）或未写入磁盘的.md文件，markdown-preview直接忽略 - 扩展名不被识别：写成
.MD、.mmd或.txt（除非你显式启用了该格式支持），Atom 不会自动切到 Markdown 语法模式 - 状态栏显示
Plain Text：右下角点击它，手动选Markdown；否则插件根本不加载解析逻辑 - 插件被禁用或冲突：进
Settings > Packages搜markdown-preview，确认状态为Enabled；若已装markdown-preview-plus，必须先禁用原生插件，否则两者抢控权
为什么预览不实时、滚动不同步、数学公式不显示
因为 markdown-preview 是 Atom 2015 年左右的遗留插件，它不监听编辑器光标移动，也不处理 LaTeX 块——它只在文件保存后全量重绘一次。
真正能解决问题的是 markdown-preview-plus：
- 默认开启
sync scrolling：编辑区滚动，预览区立刻跟焦对应段落 - 支持
Ctrl+Shift+X单独渲染当前光标处的 LaTeX 公式（需文档中写$$E=mc^2$$或\begin{equation}...\end{equation}） - Mermaid 图表、TOC 自动生成、表格嵌套缩进等现代 Markdown 特性全部开箱即用
- 它用的是
remark渲染器，比原生插件的marked更准、更兼容 CommonMark 规范
Preview HTML 右键菜单和 Ctrl+Shift+M 的本质区别
这是两类完全不同的机制，混用必出错：
-
Ctrl+Shift+M调用的是 Markdown 解析流程：读取.md内容 → 转 HTML → 渲染带样式的预览页 - 右键
Preview HTML是atom-html-preview插件行为：把当前文件当纯 HTML 打开 —— 对.md文件，你会看到满屏# 标题和**加粗**原文，毫无渲染 - 如果你误启用了
atom-html-preview并绑定了Ctrl+Shift+M，去Keymap设置里搜html-preview，删掉冲突绑定
导出 PDF 或复制 HTML 时样式丢失怎么办
markdown-themeable-pdf 和 pdf-view 插件导出的 PDF 不继承 Atom 主题，而是硬编码了一套极简 CSS 模板。结果就是：你在编辑器里看着很美的代码块、标题层级、引用样式，导出后全变回默认字体和间距。
真正可控的方式只有两种：
- 用
Pandoc命令行导出：pandoc doc.md -o doc.pdf --pdf-engine=xelatex，配合自定义.css或 LaTeX 模板，样式完全可控 - 在
markdown-preview-plus中右键 →Copy HTML，粘贴到支持富文本的编辑器（如 Word、Typora），再另存为 PDF；虽多一步，但保留了所有内联样式和 MathJax 渲染结果
别指望靠插件一键导出“所见即所得”的 PDF——Atom 的预览视图本身就不走浏览器渲染管线，它只是个简化版 WebView，连本地字体都未必能正确 fallback。
