第12章 使用 Mermaid AI 生成图表
用 AI 生成图表
Mermaid AI 能把自然语言转换成图表语法。描述你想展示的内容(流程、系统、数据流),它就会生成一张可用的图表。之后可以继续用对话方式调整,也可以在有了满意的结构后,切换到文本编辑器手动修改。
本指南涵盖如何通过提示词生成图表、上传文件以及优化生成结果。如果你想自己编写语法,请从创建你的第一张图表开始 →
开始之前
所有套餐均可使用 Mermaid AI。各套餐的额度不同,可在 Settings → Credits 中查看余额。比较各套餐 →
通过提示词生成图表
1. 进入你的 dashboard。 2. 点击 New diagram。 3. 在左侧面板选择 Mermaid AI。 4. 描述你想要的图表。 5. 点击 Generate。
如何写好提示词
Mermaid AI 对包含以下三要素的提示词响应最好:图表类型、主题,以及你想展示的关键元素或关系。图表类型 + 主题 + 关键元素:
与其这样写……不如这样写……“画一张我们招聘流程的图”“画一张我们招聘流程的 flowchart——阶段包括简历筛选、电话面试、技术面试、终面和发放 offer。每个阶段都加上一条被淘汰的分支。”“展示我们 API 的工作方式”“画一张 sequence diagram,展示移动应用如何通过 OAuth 向我们的 API 进行身份验证——参与者是应用、认证服务器和资源服务器。”“我们的团队架构”“画一张 flowchart 组织架构图:顶部是 CEO,下面是三位 VP(Engineering、Product、Marketing),每位 VP 下设两名直属下属。”
更多按图表类型的示例:
图表类型示例提示词Flowchart“画一张内容生产工作流的 flowchart:阶段包括 brief、draft、review、revision、approval 和 publish。审核不通过时,加一条回到 draft 的返工循环。”Sequence diagram“画一张 sequence diagram,展示用户重置密码的过程:参与者是用户、Web 应用和邮件服务。”ER diagram“为 SaaS 产品画一张 ER diagram,包含 users、organizations、subscriptions 和 invoices,展示它们之间的关系和基数。”Gantt chart“画一张为期三个月的网站改版 Gantt chart:阶段包括 discovery、design、development、QA 和 launch。”Mindmap“画一张内容营销策略的 mindmap:分支包括渠道、形式、分发和效果衡量。”State diagram“为订单管理系统画一张 state diagram:状态包括 pending、confirmed、processing、shipped、delivered 和 cancelled。”
从文件生成
已经有现成的文档?上传文件,让 Mermaid AI 提取其中的结构。
1. 打开 Mermaid AI 面板。 2. 点击输入框中的附件图标。 3. 上传文件——支持 PDF、Word 和纯文本等格式。 4. 告诉 Mermaid AI 你想怎么处理它。
适用场景:
文件类型可以这样要求会议记录“把这些内容转成一张 flowchart,展示待办事项和负责人”PRD 或规格文档“生成一张 sequence diagram,展示文档中描述的主要用户流程”流程文档“根据文档中的步骤画一张 flowchart”组织架构文档“根据文档中描述的团队结构画一张组织架构图”
Mermaid AI 会在整个对话过程中保留上传文件的上下文。比如你上传了一份 PRD 并生成了一张 sequence diagram,之后可以直接说“现在展示一下错误状态”或“加上管理员流程”,无需重新上传。上下文在整个会话期间保持有效。
优化生成结果
如果第一次结果不理想,可以继续对话。Mermaid AI 了解它刚生成的图表——你可以要求针对性修改,而不必从头再来。
增删元素:
需求怎么提添加步骤“在‘Approved’和‘Published’之间加一个‘Under legal review’步骤”删除节点“删掉‘Notify manager’这一步”添加判断分支“从‘Review’到‘Draft’加一条驳回路径”添加 subgraph“把三个 database 节点归到一个叫‘Data layer’的 subgraph 里”
调整结构或布局:
需求怎么提改变方向“改成从左到右布局,不要从上到下”更改图表类型“把这张图转成 sequence diagram”简化“太复杂了——把中间部分合并成一个叫‘Internal processing’的节点”拆分为多个部分“把它拆成两个 subgraph——一个放前端流程,一个放后端流程”
调整样式:
需求怎么提为特定节点着色“把判断节点改成黄色,终点节点改成绿色”高亮某条路径“把关键路径的箭头加粗”应用主题“给整张图应用 forest 主题”
应用前先审查修改
如果图表有语法错误无法渲染,可以打开 Mermaid AI 面板并点击 Fix with AI。它会定位问题、提出修复方案,并在应用前展示 diff。
当你手动编辑语法时中途出了问题,这个功能特别有用——比自己在代码里排查快得多。审查后点击 Apply 确认,或点击 Discard 放弃。
切换到文本编辑器
图表基本成型后,可以切换到文本编辑器做精细调整。Mermaid AI 生成的都是标准 Mermaid 语法——完全归你所有,可以直接编辑。
AI 面板和文本编辑器保持同步,任何一边的改动都会反映到另一边。
对 Mermaid 语法不熟悉?阅读语法指南 →
常见问题
生成了错误的图表类型。在提示词中明确指定类型,例如“画一张 sequence diagram,展示……”。不指定的话,Mermaid AI 会根据上下文推断类型,通常准确,但不一定每次都对。
图表太复杂。直接告诉它:“太细了——简化一下,把中间部分合并。”它会在原有基础上调整,不会推倒重来。
缺少关键元素。具体提出来:“你漏掉了 review 和 publishing 之间的审批步骤,请把它加到这两个节点之间。”针对性的请求会得到针对性的修改。
布局不易阅读。让 Mermaid AI 改变方向:“改成从左到右”或“切换成从上到下布局”。对复杂图表来说,方向对可读性影响很大。
额度用完了。额度随套餐按年补充。如需增加额度或升级套餐,前往 Settings → Credits 或查看套餐选项。
下一步
应用主题或自定义节点颜色 | 应用主题 → 导出为 PNG、SVG 或发送实时链接 | 分享你的图表 → 学习语法,从零开始编辑和构建 | 编写图表语法 →