默认的markdown-preview不能直接用，因为它不支持数学公式、不自动刷新、无同步滚动，且仅对已保存的.md文件渲染，未保存时会报“cannot preview unsaved buffer”错误；必须禁用原生插件，改用markdown-preview-plus并启用mathjax、auto-refresh和synchronize preview scroll。
为什么默认的 markdown-preview 不能直接用
它不支持数学公式、不自动刷新、没有同步滚动，预览窗口常为空白——根本原因是 Atom 默认只对已保存的 .md 文件触发渲染，未保存的 buffer 会直接报错 Cannot preview unsaved buffer。你 Ctrl+Shift+M 按了没反应，大概率卡在这一步。
必须换掉原生插件并装 markdown-preview-plus
装完后第一步不是打开预览，而是去 Settings → Packages → markdown-preview-plus → Settings，把 Enable MathJax 勾上（写公式才需要），再确认 Auto-Refresh 和 Synchronize Preview Scroll 都已启用。
- 快捷键
Ctrl+Shift+M（Windows/Linux）或Cmd+Shift+M（macOS）默认被占用？去 Settings → Keybindings 搜索markdown-preview-plus:toggle重映射 - 如果预览仍空白，检查文件是否已保存为
.md后缀；临时文件名如untitled不会被识别 - 装完别忘了禁用系统自带的
markdown-preview插件，否则两者会冲突，导致同步滚动失效
markdown-scroll-sync 其实不用装
markdown-preview-plus 自带同步滚动，只要在它的设置里开了 Synchronize Preview Scroll 就行。单独装 markdown-scroll-sync 反而容易和新版 markdown-preview-plus 不兼容——尤其当你用的是 2.4.16 或更高版本时，官方明确提示“不要额外安装”。
图片粘贴失败的三个硬条件
markdown-img-paste 或 markdown-image-paste 插件不是装完就灵，它依赖三个不可绕过的状态：
- 当前文件必须已保存（路径才能推导出图片存哪）
- 剪切板内容必须是位图（PNG/JPEG），不能是网页链接或纯文本
- 目标目录得存在——比如配置里设了
assets/，但文件夹没手动创建，控制台就会报ENOENT
路径配置写错也常见：Windows 用户在 _mdwriter.cson 或插件设置里用单反斜杠 ，会被当转义符吃掉，得写成 / 或 \。
