必须禁用原生 markdown-preview 并安装启用 markdown-preview-plus 才能实现边写边看、滚动同步和公式渲染;需确保文件已保存、扩展名为小写 .md 或 .markdown、状态栏显示 markdown 模式,且无插件冲突。

Atom 自带的 markdown-preview 插件默认不实时更新,必须换用 markdown-preview-plus 才能真正实现边写边看、滚动同步、公式渲染。
Ctrl+Shift+M 没反应?先检查这四件事
快捷键失效不是 Atom 坏了,而是触发链断在某个环节:
- 文件没保存:
untitled或未写入磁盘的.md文件,插件直接跳过处理 - 扩展名不匹配:写成
.MD、.mmd或.txt—— Atom 只认小写.md、.markdown等白名单后缀 - 状态栏显示
Plain Text:右下角点击它,手动切换为Markdown,否则语法解析器根本没加载 - 插件被禁用或冲突:进
Settings > Packages搜markdown-preview,确认状态是Enabled;如果已装markdown-preview-plus,必须先禁用原生插件,否则两者抢控权
为什么原生插件预览不同步、公式不渲染
markdown-preview 是 Atom 2015 年左右的遗留实现,它只在文件保存后全量重绘一次,不监听光标移动、不解析 LaTeX 块、也不做滚动位置映射。
Convert Chinese patent PDFs/DOCX/DOCs to structured Markdown. Supports patent publications (A/B/U) and office action documents (审查意见通知书/驳回决定/复审决定书/无效宣告请求审查决定书). Uses MinerU for high-quality OCR text extraction (falls back to Tesseract), Python scripts for
真正可用的是 markdown-preview-plus:
- 默认开启
sync scrolling:编辑区滚动时,预览区自动定位到对应段落 - 支持
Ctrl+Shift+X单独渲染当前光标处的 LaTeX 公式(如$$E=mc^2$$) - 对嵌套列表、缩进敏感的 Markdown 结构更稳定,表格和 TOC 渲染也更准
安装与启用 markdown-preview-plus 的实操步骤
别再用原生插件凑合,三步到位:
- 进
Settings > Packages,搜markdown-preview,点右侧齿轮图标 →Disable(必须先禁用原生插件) - 同页面搜
markdown-preview-plus,点Install;或命令行运行apm install markdown-preview-plus - 重启 Atom,打开一个已保存的
.md文件,按Ctrl+Shift+M—— 此时预览应实时响应编辑,并支持同步滚动
最容易被忽略的是:插件启用后,Ctrl+Shift+M 仍可能因文件路径含中文或空格而静默失败;若预览窗口一闪即逝,大概率是状态栏没切到 Markdown 模式,而不是配置问题。










