# OpenMMD

**官方网站：[https://www.openmmd.com](https://www.openmmd.com)**

OpenMMD 是一个“更适合 AI 看的流程图，人类编辑也方便”的工具。

它解决的是一个很实际的问题：很多时候我们需要画流程图，画成图片人类看得很明白，但如果想把这张图发给 AI 帮我们写代码或分析逻辑，AI 往往看不懂。

## 什么是 Mermaid？

可能你还不了解 Mermaid。简单来说，Mermaid 是一种“用代码文本来画流程图”的技术。

**为什么我们需要它？**

因为 AI 不擅长看图片的流程图。人类看图片一目了然，但 AI 只能通过图像识别去“猜”图片里的框框和线条，经常猜错它们之间的逻辑关系。

但 AI 非常擅长看 Mermaid 流程图。因为 Mermaid 本质上是一段结构化的文本代码，里面清晰地写明了节点、分支和连接关系。AI 读这段代码就像读它的母语一样，能准确无误地理解图表的完整结构。

## OpenMMD 的工作原理

虽然 Mermaid 对 AI 很好，但让人类去手写代码画图太反人类了。人类更擅长的是鼠标拖拽、连线。

所以 OpenMMD 的原理是：

1. **人类用自己擅长的方式画图**：通过图形化的拖拽界面制作流程图，完全不需要懂任何代码。
2. **导出图片给人类看**：可以导出一张清晰的 PNG 图片，方便发给同事、放入文档。
3. **导出代码给 AI 看**：可以导出背后的 Mermaid 代码，发给 AI，让 AI 真正读懂你的逻辑并继续为你工作。

## 支持的能力

- 可视化编辑 Mermaid 图表
- 导出 PNG 图片
- 导出 Mermaid 代码
- 导出 Markdown 文件
- Markdown 中同时包含：
  - SVG 图表预览
  - Mermaid 代码块

这对文档沉淀、AI 协作、知识库管理都非常有价值。

## 适合哪些人

### 产品经理

可以先画流程图、交互图、时序图，再把 Mermaid 代码交给 AI 去补充边界情况、重写需求、完善交付文档。

### 开发者

可以把 Mermaid 图作为架构说明、系统行为说明、接口时序说明的一部分，直接纳入仓库和 AI 编程流程。

### 独立开发者与一人公司

可以把思考、画图、文档、AI 提示和实现工作连接在一起，用更轻的方式推进产品。

### 想让 AI 编程更符合预期的人

如果你希望 AI 生成的代码和实现方案更贴近真实业务流程，Mermaid 往往比图片更有效，因为它把结构直接交给了 AI。

## 本地存储与 GitHub 同步

OpenMMD 默认采用本地优先的存储方式。

这意味着：

- 使用更快
- 数据更贴近自己掌控
- 没有额外的接入门槛

同时，你也可以把数据同步到自己的 GitHub 仓库中。

这样做的好处是：

- 可以把图表纳入现有仓库体系
- 方便备份和迁移
- 更适合与 Markdown 文档一起管理

## 与 Obsidian 配合

如果你使用 Obsidian，并且采用 Git 仓库同步知识库，那么 OpenMMD 很适合与你现有的仓库配合。

一种典型方式是：

1. 在 OpenMMD 中编辑图表
2. 导出 Markdown 和 Mermaid 代码
3. 存入自己的 GitHub 仓库
4. 在 Obsidian 中通过同一个仓库同步查看和整理

这样图表、说明、产品文档和知识库都能进入同一条工作流。

## 核心结论

OpenMMD 的核心不是“又一个画图工具”。

它更像是一个让图表同时服务于：

- 人类阅读
- AI 理解
- Markdown 文档
- GitHub 仓库
- Obsidian 知识库

的 Mermaid 工作台。

一句话总结：

OpenMMD 让你画出给人看的图，也保留给 AI 读得懂的结构。