Excalidraw 结合 AI 怎么画架构图:Mermaid 代码一键转手绘风图表与 Excalidraw MCP 自动生图做法

想用 AI 快速画出可自由拖拽修改的手绘风系统架构图?本文整理 Excalidraw 内置 Mermaid 转图表、Text to Diagram 与挂载 Excalidraw MCP 自动读取代码生成架构图的三套完整流程。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

  1. 最稳妥的免费路线是「大模型写 Mermaid + Excalidraw 一键转换」:先让 Claude 或 ChatGPT 输出标准 flowchart 或 sequenceDiagram 代码,再贴进 Excalidraw 的「更多工具(More tools)> Mermaid to Excalidraw」,生成的方框、箭头和文字都是原生可编辑元素。
  2. 网页端自带「Text to Diagram」可直接用自然语言生图:无需手写语法,输入中文或英文系统描述即可在右侧预览草图,但免费版有每日生成次数限制。
  3. 并非所有 Mermaid 图类都能转成可拆分节点:按官方 @excalidraw/mermaid-to-excalidraw 说明,流程图、时序图和类图支持转为原生矢量元素;甘特图等尚未原生适配的语法会回退成一张整体图片。
  4. 研发仓库可挂载 Excalidraw MCP 自动出图:将远程 https://api.excalidraw.com/api/v1/mcp 或本地转换 MCP 接入编程工具后,模型能边读微服务目录边生成画布,省去来回复制粘贴。
  5. 长代码梳理与架构提示词主力订阅入口:让模型从上万行源码准确提炼调用关系需要充足上下文配额,无境外银行卡可前往本站自助开通 Claude Pro、Claude Code 或 ChatGPT Plus。

Excalidraw 结合 AI 画架构图三种方式对比

图:本站根据 Excalidraw 官方文档:Mermaid to Excalidraw 整理的示意图

本文根据 Excalidraw 官方文档《Mermaid to Excalidraw》与 Model Context Protocol 官方规范整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Excalidraw 或 Anthropic 官方网站。

适用于谁

  • 写技术方案、汇报材料或毕业设计时,想把系统调用链路快速画成清爽手绘风架构图的开发者与产品经理;
  • 用大模型生成了 Mermaid 代码,觉得默认渲染样式太呆板、连线没法手动微调的人;
  • 想在 Claude Desktop、Claude Code 或 Cursor 里直接读取本地代码仓库,通过 MCP 自动生成架构草图的团队。

一、路线一:用大模型生成 Mermaid 再转手绘矢量图

直接在画布里手拖几十个微服务框非常耗时,而直接让生图模型画架构图又经常出现英文拼写错乱、箭头指错且无法二次编辑的问题。用结构化代码做中间层是目前效率最高的方法,基础流程图语法可参考 ChatGPT 怎么画流程图和做图表。

实操只需四步:

  1. 发提示词生成精简 Mermaid 代码:向 Claude 或 ChatGPT 发送模块清单,严格限制单节点字数与分层结构(可直接复制下方模板):
text
请根据以下业务说明,输出一段标准的 Mermaid flowchart TD 代码,用于导入 Excalidraw:
1. 按「客户端接入层 -> 网关与鉴权层 -> 核心微服务层 -> 缓存与存储层」用 subgraph 分成 4 层;
2. 每个节点文案控制在 12 个字以内,节点标签统一加英文双引号避免括号语法报错;
3. 箭头上用简短动词标明协议或动作(如 REST、gRPC、写入队列);
4. 只输出纯 mermaid 代码块,业务组件如下:[在此粘贴你的模块列表或接口代码]
  1. 打开转换窗口:浏览器访问 excalidraw.com,点击顶部工具栏最右侧的「更多工具(More tools)」,选择「Mermaid to Excalidraw」。
  2. 粘贴并实时预览:将代码块内容粘贴到左侧输入框,右侧会立即渲染出手绘风格的预览图;确认无语法报错后点击「插入(Insert)」落入主画布。
  3. 手动分组改色:选中不同 subgraph 区块更换浅底色(如接入层用浅蓝、数据库用浅黄),拖拽调整重叠连线,最后点左上角菜单「导出图片(Export image)」保存为 SVG 或高倍率 PNG。

二、路线二:画布内置 Text to Diagram 一句话生成草图

如果你手头还没有整理好的模块清单,只想快速画一个业务泳道或登录鉴权草图,可以直接使用 Excalidraw 网页端内置的 AI 生成面板:

  1. 点击顶部工具栏「更多工具(More tools)> Text to Diagram(文字转图表)」;
  2. 在输入框写清输入、处理步骤和分支判断,例如:「用户提交订单后先扣减 Redis 预占库存,成功则异步发送支付单消息,超时 15 分钟未支付则回滚库存」;
  3. 点击生成后,后台会自动先将自然语言转成图结构再渲染成手绘节点,点击插入即可继续编辑。

需要注意,网页免费端内置的每日 AI 生成额度有限。遇到复杂多分支架构时,自己在外部对话窗口先打磨好逻辑再贴进来,比在弹窗里反复重试更省时间,在终端工具里出图的思路也可对照 Claude Code 能画图吗:流程图、架构图、原型页生成做法。

主力编程模型订阅准备提示:梳理大型单体仓库或微服务链路时,免费版对话窗口极易因代码文件超长而截断报错。若国内缺乏外币信用卡升级模型配额,可在本站通过支付宝或微信支付自助开通 Claude Pro(擅长长上下文代码阅读与严谨 Mermaid 语法生成)或 ChatGPT Plus,团队采购还可查看 AI 会员充值中心。

三、路线三:挂载 Excalidraw MCP 从代码仓库直接生图

在日常维护工程文档时,把 MCP(概念入门见 MCP 是什么:Model Context Protocol 入门)接入编辑器或桌面客户端,可以让 AI 读完源码目录后直接调用绘图工具创建架构图。目前主流有两种接入形态:

接入形态典型配置方式特点与权限边界
官方 Excalidraw+ 远程 MCP在支持远程 Streamable HTTP 的客户端添加 https://api.excalidraw.com/api/v1/mcp 并完成账号 OAuth 授权直接在云端工作区生成在线协作画布,适合团队评审共享
本地 .excalidraw 文件转换让 Claude Code 或本地 MCP 脚本调用 @excalidraw/mermaid-to-excalidraw 生成 .excalidraw 文件存进仓库 docs/ 目录架构图源码随 Git 版本库提交,配合 VS Code 或 Obsidian 插件本地预览,代码不外发第三方画板

以本地工作流为例,在项目根目录对编程助手下达指令:「读取 src/modules/ 下各服务的路由与消息订阅代码,梳理核心依赖关系,先输出核对清单,确认无误后转换为标准图文件保存到 docs/architecture.excalidraw」,后续每次改接口都能顺手更新架构图。如果还想把需求拆成脑图,也可搭配 ChatGPT 怎么做思维导图:用 Mermaid 代码生成并预览。

Excalidraw AI 转图报错与排版乱象排查

图:本站根据 Excalidraw 官方文档:Mermaid to Excalidraw 整理的示意图

四、常见转换报错与排版乱象修复

把大模型吐出的代码贴进 Excalidraw 时,最容易遇到三类问题:

  1. 报 Parse error 语法解析失败:最常见原因是大模型在节点文字里写了半角圆括号 () 或方括号 [],与 Mermaid 节点形状定界符冲突。修复办法是让模型把节点标签统一用英文双引号包起来,写成 A["订单服务 (Order)"]。
  2. 生成的图无法拆开编辑、变成一整张死图:检查第一行图类型声明。当前 flowchart、sequenceDiagram 与 classDiagram 可转为独立手绘框,若模型用了尚未原生矢量映射的类型,转换器会自动退化为静态图片插入。
  3. 横向排布过宽导致字小看不清:超过 12 个节点的系统图不要用 flowchart LR(从左到右),统一改成 flowchart TD(从上到下),并把巨型图按「全局部署拓扑图」和「核心单据状态流转图」拆成两张画布。

常见问题

问:Excalidraw 网页版画的架构图会自动上传服务器吗?

答:开源版 excalidraw.com 默认保存在浏览器本地存储(Local Storage)中;只有主动开启「实时协作(Live collaboration)」或生成分享链接时才会加密传输。敏感架构建议直接存 .excalidraw 本地文件。

问:导出架构图贴进文档怎么去白底、防模糊?

答:点击左上角菜单「导出图片(Export image)」,关闭「背景(Background)」开关即可透明;支持矢量优先选 SVG,否则切 2x 或 3x 导 PNG。

问:中文手写字体能换成规整字体吗?

答:按 Ctrl+A 全选元素,在左侧「字体(Font family)」切为普通(Normal)或等宽(Code),边框凌乱度(Sloppiness)选「建筑师(Architect)」即可变成规整配图。

问:国内没有外币卡,想订 Claude Pro 或 ChatGPT Plus 配合画架构图和写方案怎么开通,能开发票吗?

答:可前往本站 Claude Pro 充值页、ChatGPT Plus 充值页 或 AI 会员充值总览 自助办理,支持支付宝、微信支付及 AlipayHK 结算(含免交账号密码的自助卡密兑换模式),企业采购支持申请开具国内增值税发票;各档实时价格与售后细则(掉订阅按剩余天数折退,封号不在质保范围)均以商品页当日说明为准。

相关教程

参考资料

  • Excalidraw 官方开发文档:Mermaid to Excalidraw — https://docs.excalidraw.com/docs/codebase/mermaid-to-excalidraw
  • Excalidraw 官方网站与在线画布 — https://excalidraw.com/
  • Model Context Protocol 官方架构介绍 — https://modelcontextprotocol.io/introduction

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~