内容提要
text2mermaid是一个通过自然语言生成Mermaid图的网站,支持流程图、时序图、ERD等七种图,可实时预览并导出SVG/PNG。作者因手写Mermaid语法繁琐而开发,旨在简化画图流程,免注册免费使用,适合技术文档、系统设计和评审场景。
延伸解读
为什么选择 Mermaid 而非传统画图工具
文章指出,draw.io 和 excalidraw 等拖拽式工具虽然好看,但出图不可 diff,修改后需重新导出图片贴回文档,难以跟上文档节奏。而 Mermaid 作为代码即图的方案,可以存在 markdown 里、进 git、可 diff、跟着 PR 走版本,且 GitHub、GitLab、Notion 等平台原生支持渲染。对于频繁更新技术文档的开发者,这种可版本控制的特性是传统工具难以替代的。
AI 生成 Mermaid 的常见问题与解决思路
作者提到,直接让 ChatGPT 或 Claude 生成 Mermaid 代码,往往需要多步操作:开对话、粘贴描述、复制代码、贴到文档,且大模型经常生成语法看似正确但渲染不出来的代码。text2mermaid 的设计目标是提供一个专门入口,打开即用,回车即预览,生成错误时能自动修复,从而减少上下文切换和手动修正的麻烦。
适用场景与使用建议
文章列举了三个实际场景:写系统设计文档时画时序图、评审前快速画 ER 图、画 CI/CD 的 flowchart。这些场景的共同点是需要快速生成可编辑的图,且图会频繁修改。作者建议,如果生成结果不合适,可以直接编辑代码或回到手写,不会造成损失。对于分支多、结构复杂的图,AI 自动整理节点位置也能减轻维护负担。
Q&A
text2mermaid是什么?它有什么主要功能?
text2mermaid是一个用自然语言生成Mermaid图的网站,支持流程图、时序图、ERD等七种图,可实时预览并导出SVG/PNG,免注册免费使用。
text2mermaid支持哪些类型的图?
支持七种图:流程图(flowchart)、时序图(sequence diagram)、ER图(ERD)、状态图(state diagram)、类图(class diagram)、思维导图(mindmap)和甘特图(gantt)。
text2mermaid相比手写Mermaid有什么优势?
优势在于无需记忆复杂的Mermaid语法,用自然语言描述即可生成代码,并实时预览,减少语法错误和上下文切换,提高效率。
text2mermaid相比draw.io等拖拽工具有什么优势?
相比draw.io等拖拽工具,text2mermaid生成的图是代码形式,可diff、可版本控制,且修改方便,更贴合文档工作流。
text2mermaid怎么使用?
打开网站,在顶部输入区用中文或英文描述想要的图,按⌘/Ctrl+Enter生成,左侧代码右侧预览,可切换视图,支持导出SVG/PNG或复制代码。
text2mermaid有哪些实际应用场景?
适合写系统设计文档时画时序图、评审前快速画ER图、画CI/CD的flowchart等场景,能快速生成可编辑的图。
text2mermaid是否免费?需要注册吗?
免注册免费使用,目前作者自己也在用,希望更多人尝试。
text2mermaid生成的代码是否可移植?
可以,生成的代码是纯文本,可复制到markdown中,导出的SVG也是纯文本,可放入git仓库,不锁定在网站。