Atom不内置Markdown实时预览，需手动安装并启用官方markdown-preview插件；默认快捷键Ctrl+Shift+M可能冲突，建议重绑定；预览样式与GitHub不一致需开启gfm:true或换用增强插件。

Atom 编辑器本身不内置 Markdown 实时预览功能，必须安装并启用 markdown-preview 插件，且需注意其默认快捷键与系统冲突、渲染行为与 CommonMark 兼容性等实际问题。

如何安装并启用 markdown-preview 插件

Atom 1.50+ 版本已不再默认捆绑 markdown-preview，需手动安装：

• 打开 Atom → Settings → Install，搜索 markdown-preview
• 确认安装的是官方维护的包：markdown-preview（作者：atom），不是 markdown-preview-plus 或其他衍生版
• 安装后无需重启，但需确保该插件在 Settings → Packages 中状态为 Enabled
• 若已安装却无反应，检查是否被 markdown-writer 等插件禁用了预览入口

怎么触发实时预览窗口

默认快捷键是 Ctrl+Shift+M（Windows/Linux）或 Cmd+Shift+M（macOS），但 macOS 上常与系统“语音控制”冲突，导致无响应：

Markdown Canvas

将Markdown文件转换为美观的HTML页面，适用于Canvas或浏览器查看。用于用户请求渲染、可视化、显示或分享Markdown文件时。

下载

• 可手动通过菜单触发：Packages → markdown-preview → Toggle Preview
• 推荐重绑定快捷键：进入 Settings → Keybindings，搜索 markdown-preview:toggle，点击右侧铅笔图标添加自定义快捷键（例如 Ctrl+Alt+P）
• 预览窗口默认在右侧分栏打开；若想浮动显示，需额外安装 markdown-preview-opener 插件

为什么预览样式和 GitHub 不一致

markdown-preview 默认使用 Atom 自带的样式（基于旧版 marked 解析器），不完全遵循 GitHub Flavored Markdown（GFM）规范：

• 表格、任务列表、自动链接等 GFM 特性可能渲染异常或缺失
• 解决方法：安装 markdown-preview-enhanced（注意它和原生 markdown-preview 冲突，需先禁用后者）
• 若坚持用原生插件，可在 config.cson 中强制启用 GFM 模式：

  "markdown-preview":
    "gfm": true

• 注意：开启 gfm: true 后，本地相对图片路径（如 ![](img/foo.png)）可能因 base URL 问题无法加载，需配合 markdown-preview:enable-image-auto-resolve 设置

预览卡顿或不自动刷新怎么办

常见于大文件（>1000 行）或含大量内联 HTML/脚本的 Markdown：

• 关闭自动刷新：Settings → Packages → markdown-preview → Uncheck "Auto Update Preview"，改用手动刷新（Ctrl+R 在预览窗内）
• 避免在 Markdown 中写 <script></script> 或复杂 CSS —— markdown-preview 不沙箱执行 JS，存在安全风险且必然卡死
• 若频繁编辑并保存，建议开启 core:confirmCheckoutModified 防止误关未保存预览页
• 真正稳定的替代方案其实是外部服务：用 marked CLI + BrowserSync，或直接用 VS Code 的 Markdown All in One（更现代、GFM 准确度高）

最易被忽略的一点：Atom 的 markdown-preview 不监听文件系统变更事件，只响应 Atom 编辑器内的编辑动作。如果用命令行或其它编辑器同步修改同一文件，预览不会更新 —— 这不是 bug，是设计如此。