画布导入导出 — JSON、Mermaid、PNG、SVG
导出格式
画布可以导出为以下格式：
| 格式 | 内容 | 用途 |
|---|---|---|
| PNG 图片 | 画布渲染成位图 | 嵌入文章、分享、演示 |
| SVG 图片 | 画布渲染成矢量图 | 无损缩放、网页展示、专业设计软件 |
| 画布 JSON | NoteGen 原生格式 | 备份、跨设备同步、再次导入 NoteGen |
| Mermaid 流程图 | flowchart/graph 语法 | 嵌入 Markdown、迁移到支持 Mermaid 的平台 |
选择导出范围
导出前可以：
- 导出整个画布
- 导出选中的元素（框选一部分后只导出这部分）
- 适应视图后再导出（缩放/平移到合适的显示范围）
导出时画布范围决定了图片/文件里包含什么。
PNG vs SVG
- PNG——位图，放大模糊。适合嵌入 Markdown 笔记、发微信等即时通讯、用作文章配图
- SVG——矢量图，放大不糊。适合嵌入网站、文档、演示文稿，适合打印
如果是要嵌入 NoteGen 自己的 Markdown 文件，两种都行——NoteGen 都能渲染。
Mermaid 导出
Mermaid 导出有一个重要限制——只覆盖可映射的元素：
| 画布元素 | 能否导出到 Mermaid |
|---|---|
| 流程图节点（矩形/菱形/圆角矩形） | ✅ |
| 连接线 | ✅ |
| 文本节点（纯文字） | ⚠️ 保留文字 |
| 手绘 | ❌ 丢失 |
| 图片 | ❌ 丢失 |
| 图表 | ❌ 丢失 |
| 分组 | ❌ 丢失 |
Mermaid flowchart 语法只能表达节点和连线，其他元素不支持。需要无损备份时选择画布 JSON。
画布 JSON 导入
画布 JSON 是 NoteGen 的原生格式，包含所有元素的完整信息。导入后完全还原，不丢任何内容。
用途：
- 跨设备同步画布（画布不在 Git 同步的工作区文件里，单独备份）
- 画布版本回滚
- 跨工作区复制画布
Mermaid 导入
Mermaid flowchart/graph 语法可以导入为画布：
flowchart TD
A[记录] --> B[整理]
B --> C[写作]导入后变成可编辑的画布元素，可以继续添加图片、手绘、分组等 Mermaid 不支持的内容。
图片导出常见问题
导出异常/空白：
- 缩小画布范围，先适应视图再导出
- 检查远程图片是否可访问（画布里引用的网络图片如果加载失败，导出可能空白）
- 复杂大画布分几次导出（选中部分元素分别导出）
SVG 太大：
- 如果画布很复杂，SVG 文件会比较大。可以导出 PNG 控制体积。
画布同步
画布数据存在 NoteGen 应用数据中（不是工作区文件）。启用记录与配置同步后，画布会随结构化数据一同同步到你选择的同步服务。
同步失败时，列表会显示"待上传"或"失败"状态。不要重复删除并重建画布——先保留本地数据，检查同步队列。