必须禁用原生markdown-preview并安装markdown-preview-plus才能实现真正实时预览;需确保文件已保存、扩展名为小写.md/.markdown、状态栏显示markdown、路径无中文或空格,且无插件冲突。

Atom 自带的 markdown-preview 插件不支持真正意义上的实时预览——它只在保存后刷新一次,滚动不同步,也不渲染 LaTeX 公式。必须换用 markdown-preview-plus 才能达成边写边看、光标定位同步、公式按需渲染的效果。
为什么 Ctrl+Shift+M 没反应或预览空白
这不是快捷键绑定失败,而是触发链被几个硬性条件卡住:
- 文件未保存:
untitled或路径含中文/空格时,插件直接跳过加载(哪怕内容是 Markdown) - 扩展名不合法:Atom 只识别小写的
.md或.markdown;.MD、.mmd、.txt(除非手动配置 grammar)均无效 - 状态栏显示
Plain Text:右下角点击它,手动选Markdown—— 否则语法解析器根本没启动 - 原生插件未禁用:
markdown-preview和markdown-preview-plus会抢控权,必须先禁用前者
安装 markdown-preview-plus 的三步实操
别在 Settings 里点两次 Install,顺序错了就白装:
- 进
Settings > Packages,搜markdown-preview,点右侧齿轮 →Disable(必须做) - 同页面搜
markdown-preview-plus,点Install;或终端运行apm install markdown-preview-plus - 重启 Atom,打开一个已保存的
.md文件,确认右下角状态栏是Markdown,再按Ctrl+Shift+M
markdown-preview-plus 关键功能与验证方式
装完不是万事大吉,得验证它真在工作:
- 滚动同步:编辑区往下滚几行,预览区应自动定位到对应段落(默认开启,无需配置)
- LaTeX 渲染:光标放在
$$E = mc^2$$块内,按Ctrl+Shift+X单独渲染该公式 - 实时响应:删一个字符、加一个空格,预览区应在 1 秒内更新(不依赖保存)
- 表格/TOC 渲染更准:嵌套列表缩进错一位,原生插件常崩,
markdown-preview-plus更鲁棒
容易被忽略的兼容性细节
即使上述全满足,仍可能出问题:
- 路径含空格或中文时,
Ctrl+Shift+M会静默失败(预览窗口一闪即逝),改用命令面板:按Ctrl+Shift+P,输入markdown preview toggle回车 -
markdown-preview-plus默认不继承 GitHub 样式,如需一致外观,进Packages > markdown-preview-plus > Settings,勾选Use GitHub.com style - 公式渲染依赖 MathJax,默认开启;若页面出现
$$...$$原样显示,检查插件设置里的Math Processing是否为MathJax











