必须禁用原生 markdown-preview 并安装 markdown-preview-plus 才能实现边写边看、滚动同步和公式渲染；常见问题包括文件未保存、扩展名非小写 .md/.markdown、状态栏未切为 Markdown 模式、插件冲突或路径含中文/空格。
Atom 自带的 markdown-preview 插件不支持实时预览，必须换成 markdown-preview-plus 才能真正边写边看、滚动同步、渲染公式。
为什么 Ctrl+Shift+M 没反应或预览不更新
快捷键失效或预览静默，通常不是 Atom 崩了，而是触发链断在以下任一环节：
- 文件没保存：
untitled或未写入磁盘的文件，插件直接跳过处理 - 扩展名不匹配：Atom 只认小写
.md、.markdown；写成.MD、.mmd、.txt都不行 - 状态栏显示
Plain Text：右下角点击它，手动切换为Markdown，否则语法解析器根本没加载 - 插件冲突：已装
markdown-preview-plus却没禁用原生markdown-preview，两者抢控权，预览窗口可能一闪即逝
必须禁用原生插件再装 markdown-preview-plus
原生 markdown-preview 是 2015 年遗留实现，只在保存后全量重绘一次，不监听光标、不解析 LaTeX、不做滚动映射。替换是硬性前提：
- 进
Settings > Packages，搜markdown-preview，点右侧齿轮 →Disable - 同页面搜
markdown-preview-plus，点Install；或终端运行apm install markdown-preview-plus - 重启 Atom，打开一个已保存的
.md文件，再按Ctrl+Shift+M
此时预览应实时响应编辑，光标移动时右侧自动滚动到对应段落。
公式渲染和同步滚动要单独确认
markdown-preview-plus 默认开启同步滚动，但部分旧版本或系统路径含中文/空格时会失效；LaTeX 渲染也需注意触发方式：
- 公式块如
$$E=mc^2$$不会自动渲染，需将光标置于其中，按Ctrl+Shift+X单独触发 - 若滚动不同步，检查是否误启了
markdown-scroll-sync—— 它与新版markdown-preview-plus（≥3.x）存在兼容问题，建议直接卸载 - 预览窗口一闪即逝？90% 是状态栏没切到
Markdown模式，而不是配置或安装失败
最容易被忽略的是：插件启用后，Ctrl+Shift+M 在中文路径或含空格的项目目录下可能静默失败，这不是 bug，是 Electron 底层对 URI 编码的限制；换用英文路径是最稳解法。
