必须禁用原生markdown-preview，改用markdown-preview-plus或markdown-preview-enhanced以实现同步滚动、实时预览和公式渲染；图片粘贴需配合markdown-img-paste且文件须已保存；代码高亮依赖language-markdown；PDF导出推荐避开phantomjs改用markdown-pdf或wkhtmltopdf。
Atom 本身不“写” Markdown，它只是编辑器；真正决定你写得顺不顺、预览准不准、导出稳不稳的，是插件组合和配置细节。默认的 markdown-preview 插件连同步滚动都不支持，开箱即用体验很差——必须换掉。
怎么让预览真正实时且可同步？
Atom 自带的 markdown-preview 插件只做基础渲染，不支持光标定位跳转、滚动不同步、数学公式报错。直接禁用它，改用 markdown-preview-plus 或更活跃维护的 markdown-preview-enhanced。
-
markdown-preview-plus：轻量、稳定，快捷键默认是Ctrl+Shift+M（Windows/Linux）或Cmd+Shift+M（macOS），但常被emmet等插件占用，务必去Settings > Keybindings检查并重映射 -
markdown-preview-enhanced：功能最全，支持 Mermaid 流程图、LaTeX 公式（需额外配 KaTeX）、HTML 导出、PDF 导出（依赖phantomjs，国内用户容易卡在安装环节） - 两者都要求：Markdown 文件必须已保存（.md 后缀），否则预览窗口可能空白或报错
Cannot preview unsaved buffer
图片粘贴为什么总失败？
原生 Atom 不支持截图→粘贴→自动存图→插入路径这一整套操作。markdown-img-paste 是唯一能闭环解决的插件，但它有三个硬性前提：
- 当前编辑的文件必须已保存（否则无法推断图片应存到哪个目录）
- 系统剪切板里必须是位图（PNG/JPEG/GIF），不能是网页链接或文字
- 默认保存路径为当前 .md 文件所在目录；若想存到
./assets/下，需在Config > Packages > markdown-img-paste > Settings中修改Image Path为assets/${filename} - 如果粘贴后没反应，先检查 Dev Tools（
Ctrl+Shift+I）控制台是否有ENOENT错误——大概率是目标目录不存在，手动创建即可
代码块高亮为啥不生效？
不是所有语言都能被识别，也不是所有主题都渲染一致。关键在两处：
- 代码块开头的三重反引号后必须紧跟语言标识，例如：
```python、```json、```bash；写成```py或空格漏掉会 fallback 到纯文本 - 语法高亮依赖
language-markdown插件——它不只是加高亮，还修复了代码块内嵌链接、表格解析等边缘 case；没装这个，markdown-preview-enhanced的代码渲染也可能异常 - 部分主题（如
one-dark-syntax）对某些语言支持弱，可临时切到github-syntax对比验证是否为主题问题
导出 PDF 总卡在 phantomjs？
markdown-themeable-pdf 插件底层调用 phantomjs 渲染 HTML → PDF，而该模块自 2021 年起已停止维护，且国内网络无法直连其 CDN。绕过方式只有两种：
- 手动下载
phantomjs二进制包（从https://phantomjs.org/download.html下对应系统版本），解压后把phantomjs可执行文件路径填入插件设置里的PhantomJS Path - 改用替代方案：
markdown-pdf（更轻量，但不支持 CSS 主题定制）或干脆用命令行工具：保存为 HTML 后，用wkhtmltopdf转——后者可控性更强，也避开了 Atom 插件生态的老化陷阱
真正卡住人的从来不是“怎么装插件”，而是插件之间隐式依赖、路径假设和未提示的先决条件。比如 markdown-img-paste 依赖文件已保存，markdown-preview-enhanced 依赖 language-markdown，而 markdown-themeable-pdf 依赖你本地有可用的 phantomjs——这些不会报红字错误，只会静默失效。
