<p>必须用mermaid代码块（大小写敏感），支持流程图（graph TD/LR）和时序图（sequenceDiagram），混用语法或标识错误会导致解析失败；Atom需启用markdown-preview-enhanced插件并手动刷新预览。</p>
能直接画，不用装额外依赖，但必须用 mermaid 语法，且代码块语言标识不能写错。
mermaid 代码块必须写对 language 标识
Atom 的 markdown-preview-enhanced 只识别明确标记为 mermaid 的代码块。写成 md、text 或留空都会不渲染图表。
- ✅ 正确写法：
```mermaid graph TD; A --> B; B --> C; ```
- ❌ 常见错误：
```markdown、```text、```（无语言） - ⚠️ 注意：大小写敏感，
Mermaid或mermaid-js都无效
流程图与时序图的语法差异和常见报错
两者都用 mermaid，但关键字不同，混用会白屏或报 Parse error。
- 流程图用
graph TD/graph LR，节点间用-->或==>连接 - 时序图必须以
sequenceDiagram开头，用participant定义角色，->>表示异步调用 - 典型错误：
sequenceDiagram里写了graph TD；或漏写participant导致整个图不显示 - 调试建议：右键预览窗口 → “Inspect Element”，看控制台是否有
mermaid parse error
预览不生效？检查 Atom 插件状态和快捷键
插件装了≠自动启用，尤其 Atom 更新后常出现“已安装但未激活”状态。
- 打开 Atom 设置 → “Packages” → 搜索
markdown-preview-enhanced→ 确认右侧开关是蓝色（启用） - 默认预览快捷键是
Ctrl+Shift+M（Windows/Linux）或Cmd+Shift+M（macOS），不是Ctrl+Shift+P - 若快捷键冲突（比如被其他插件占用），可在 Atom Keybinding Resolver 中按
Cmd+.查看当前触发的是哪个命令 - 临时验证：右键 Markdown 文件 → “Open Preview” 菜单项是否存在
导出 PNG 时路径或中文名导致失败
导出功能依赖本地 Node.js 环境，但更常卡在文件路径上。
- 导出前确保文件已保存（未保存的临时文档无法导出）
- 文件路径含空格或中文，可能导致 Puppeteer 渲染失败，建议用英文路径 + 下划线命名
- 导出按钮在预览窗口右上角，点击后选择 “Export to PNG”，不是右键菜单里的“Save As”
- 首次导出可能较慢（需启动 Chromium 实例），耐心等 3–5 秒，不要重复点击
真正容易被忽略的是：mermaid 图表在 Atom 中不支持实时热重载——改完代码块后，必须手动刷新预览窗口（Ctrl+R）或重新触发预览，否则旧图残留。
