Mermaid 提示词工程：让 LLM 准确生成图表的实用指南

让 LLM 一次性生成正确的 Mermaid 图表比看起来难得多。提问模糊会得到语法错误、错误的图表类型，或代码与解释文字混杂。提问精确则能在几秒内得到可用于生产的图表。

本指南教你 Mermaid-First 提示词策略 — 一种向 ChatGPT、Claude、Gemini 等 LLM 请求可靠图表生成的结构化方法。

Mermaid-First 提示词策略

核心原则：在描述内容之前，先声明图表类型和约束条件。

差的提示词

画一个我们的认证流程图。

好的提示词

仅输出 Mermaid 时序图代码。不要解释。

• 图表类型：sequenceDiagram
• 参与者：User, Frontend, AuthService, Database
• 流程：用户登录 → 前端发送凭证 → AuthService 验证 → 返回 JWT

提示词模板

流程图

仅输出有效的 Mermaid 代码，不要解释。
创建 flowchart TD，描述：[流程]
节点：[列出节点和关系]
最多 12 个节点。

时序图

仅输出 Mermaid sequenceDiagram 代码。
参与者：[Actor1], [Actor2], [Actor3]
交互流程：[逐步描述]

高级技巧

1. 注释优先 — 复杂图表先用 %% 注释规划结构
2. 错误修复循环 — 将渲染错误反馈给 LLM 自动修复
3. 迭代细化 — 从 4 节点开始，逐步扩展
4. 负面约束 — 明确说明不要添加样式、不要超 10 节点等

完整工作流

1. 用 Mermaid-First 模板提示 LLM
2. 复制代码到 Mermaid2Img 编辑器 预览
3. 修复错误并导出 PNG/SVG/PDF
4. 嵌入文档

常见问题

ChatGPT 生成 Mermaid 的最佳提示词？

"仅输出有效的 Mermaid 代码，不要解释。创建 [类型]，描述 [内容]。"

如何修复错误的 Mermaid？

粘贴到 Mermaid2Img 查看错误，反馈给 LLM："修复此语法错误：[错误]"

结论

Mermaid-First 策略将 LLM 变成一致的图表生成器。建立个人模板库，再也不用手动画流程图。