atom 本身不内置 markdown 实时预览，需安装 markdown-preview（启用 live preview）和 markdown-writer 两个插件即可覆盖 90% 场景；禁用 preview-plus 等冗余插件，避免冲突与样式错乱。
Atom 编辑器本身不内置 Markdown 实时预览，但通过安装少量插件可达成接近 VS Code 或 Typora 的编写体验——关键在于选对插件、配好快捷键、避开渲染冲突。
装哪几个插件才够用
只装 markdown-preview 和 markdown-writer 两个核心插件即可覆盖 90% 场景。前者负责渲染预览，后者提供标题/列表/引用等快捷插入。别装 preview-plus 或 markdown-preview-enhanced：前者已停止维护，后者依赖 Python 且常与 GitHub 渲染语法不一致，容易导出后样式错乱。
-
markdown-preview：按Ctrl+Shift+M（Windows/Linux）或Cmd+Shift+M（macOS）呼出右侧预览窗 -
markdown-writer：输入*自动转无序列表，##回车自动补全标题层级，Ctrl+Alt+T插入表格 - 如需导出 PDF，用系统级工具（如
mdpdfCLI）而非 Atom 插件——插件生成的 PDF 常丢 CSS 样式
预览窗口总不刷新？检查这些点
常见现象是改完文档后预览内容没变，不是插件坏了，而是 Atom 默认「只在保存后刷新」。如果你习惯边写边看，必须手动开启实时更新：
- 打开
Settings → Packages → markdown-preview → Settings - 勾选
Enable Live Preview（默认未勾选） - 取消勾选
Use GitHub.com Style：它强制使用 GitHub 的 CSS，会吃掉本地自定义样式，且部分语法（如任务列表- [x]）不渲染 - 如果仍卡住，关掉所有其他 Markdown 相关插件——多个预览插件共存会抢夺渲染权
中文目录和锚点失效怎么办
Atom 的 markdown-preview 对中文标题生成的锚点（如 #中文标题 → #%E4%B8%AD%E6%96%87%E6%A0%87%E9%A2%98）在点击目录跳转时经常失败，根源是 URL 编码兼容性问题。
- 临时解法：用英文或拼音写标题，例如
## zhangjie-shiyong而非## 章节使用 - 长期建议：放弃插件内建目录，改用
markdown-toc插件手动生成 TOC（支持中文），它输出的是相对链接，跳转稳定 - 不要依赖
markdown-preview的「Table of Contents」按钮——那个功能在 Atom 1.60+ 后基本不可用
Atom 已停止官方更新，但只要不升级 Electron 版本，上述配置在 1.58–1.60 稳定可用。真正难处理的是混合代码块与数学公式：markdown-preview 不支持 KaTeX，强行加脚本会导致预览页白屏，这类需求建议直接切到 Obsidian 或 Zettlr。
