ctrl+shift+m无反应是因触发条件未满足：文件未保存、扩展名非小写.md/.markdown、状态栏未设为markdown、路径含空格/中文或markdown-preview插件被禁用。
Ctrl+Shift+M 按下没反应？先检查这四件事
不是快捷键坏了，是触发链断在底层条件上。Atom 的 Markdown 预览依赖明确的运行时状态，缺一不可：
- 文件必须已保存，且扩展名是小写的
.md或.markdown（.MD、.txt、.mmd全部不认） - 右下角状态栏必须显示 Markdown —— 若显示
Plain Text，点击它手动切换 - 文件路径不能含中文或空格（如
/Users/张三/note.md或C:\My Notes\readme.md会静默失败） -
markdown-preview插件必须启用：进Settings > Packages搜索该名，确认右侧开关为 Enabled
以上任一不满足，Ctrl+Shift+M 都不会弹窗，也不会报错——它直接跳过处理。
为什么必须禁用原生 markdown-preview 并装 markdown-preview-plus
原生插件 markdown-preview 是 Atom 2015 年遗留组件，只做一次全量 HTML 渲染，不监听编辑、不支持 LaTeX、不同步滚动，连 Cannot preview unsaved buffer 这种错误都甩给用户自己猜。
markdown-preview-plus 才是当前唯一稳定可用的替代方案，它默认启用三项关键能力：
-
Synchronize Preview Scroll：编辑区滚动时，预览自动定位到对应段落 -
Auto-Refresh：内容变更后毫秒级重绘，无需手动保存 -
Enable MathJax：勾选后支持$$E=mc^2$$和\begin{equation}等块级公式（Ctrl+Shift+X可单独渲染光标处公式）
注意：markdown-preview-plus 和原生插件会抢控权。装完必须进 Settings > Packages 找到 markdown-preview，点齿轮 → Disable。
安装与启用 markdown-preview-plus 的三步实操
别被“安装插件”四个字带偏节奏，顺序和重启是硬性前提：
- 进
Settings > Packages，搜markdown-preview，点右侧齿轮图标 →Disable（必须先做） - 同页面搜
markdown-preview-plus，点Install；或终端执行apm install markdown-preview-plus -
重启 Atom（不重启，
markdown-preview-plus:export-html等命令不可用，同步滚动也不生效）
重启后打开一个已保存的 .md 文件，再按 Ctrl+Shift+M —— 此时预览应实时响应输入，并随编辑区滚动而跟焦。
预览空白、一闪即逝或导出失败的常见诱因
这些现象往往不是配置错了，而是环境或操作细节被忽略：
- 预览窗口一闪即逝：大概率是状态栏没切到
Markdown模式，而不是插件问题 - 导出 HTML 报
Cannot read property 'getEditor' of undefined：光标未落在 Markdown 编辑器内，或 Atom 未重启 - 图片粘贴失败：插件如
markdown-img-paste要求目标目录（如assets/）已存在，且路径配置中 Windows 用户需用正斜杠/，反斜杠\会被当转义符吃掉 - 公式不渲染：确认
markdown-preview-plus设置页中Enable MathJax已勾选，且文档中使用的是双美元符$$...$$或\[...\]块语法
真正卡住人的，往往是路径含空格、状态栏没切换、或忘了禁用原生插件——这三个点不解决，后面所有设置都白调。
