自由画布：转入 Excalidraw 拖动、改字、手绘标注

什么时候用画布

Mermaid 的布局由引擎算，代码是唯一的真相：改文字、加环节、换方向都是改代码，这也是它能被 AI 生成、能反复重排的原因。但有些时候你就是想用手摆——把两个节点挪开一点、在旁边画个圈写句批注、加一张截图、用手绘风格出一版给同事看。这时候点顶栏的「画布」（手机在「下载」面板里的「转入自由画布…」），当前的图会转进一块 Excalidraw 白板。不经代码直接画也可以：首页「打开画布」进的是空白画布（这台设备上有画布存档就打开存档）。

单向门：转入之后不再同步

转入是单向的。画布里的图元和编辑器里的代码从此各走各的：之后改代码、用 AI 修复、换主题，都不会影响画布；在画布上拖动、改字，也不会写回代码。代码本身仍留在编辑器里，「回到代码」随时能回去，画布内容也会保留。想让画布跟上最新代码，用画布左上角菜单里的「用编辑器里的代码重新转入」——这会替换整个画布。

对话框里会把这些写清楚，再点「转入画布」。

哪些图能拆成图元

• 能拆成可编辑图元的：流程图、时序图、类图、状态图、ER 图。节点、连线、文字各自是独立图元，可以拖动、改字、删除、加新的。
• 整图转入的：甘特图、饼图、思维导图、时间线等其余类型，以及上面五种图里转换器解析不了的写法。这些会按你当前的主题渲染成一张图片放进画布，可以摆放、缩放、在旁边标注，但不能拆开——图表型的图本来也不该用手拖，正确的做法是改数据。

转入前对话框会预告是哪一种；最终以转换结果为准。

画布里能做什么

画布就是原样嵌入的 Excalidraw（MIT 开源白板）：选择、矩形、圆、箭头、连线、文字、手绘、图片、橡皮，顶部工具栏一字排开，字体是手写风（中文用小赖手写体）。左上角菜单里有：用编辑器里的代码重新转入、打开 .excalidraw 文件、清空画布、画布底色、快捷键与帮助。右侧「素材库」可以把常用图形存起来复用。

保存与下载

• 自动保存在本机：画布内容存在这台设备的浏览器里（与代码存档分开），不上传、不进云端保存、不进分享链接。刷新或回到代码后，再点「画布」会问你「打开已有画布」还是「用当前代码重新转入」。
• 超过 4 MB 存不下：贴了很多图片时会提示；这时请下载 .excalidraw 文件留档，以后用左上角菜单「打开」。
• 下载：画布右上角「下载 PNG」，菜单里还有 SVG（内嵌字体，别处打开也是手写体）、PDF、Word、PPT、复制 PNG，以及 .excalidraw 文件（Excalidraw 自己的格式，可以再打开继续画）。倍率与透明 / 带底色的选项与单图导出相同。导出一律按浅色显示时的真实颜色——页面的暗色只是显示上的反色。Word / PPT 里没有 Mermaid 源码附录，因为画布已经没有对应的代码。

常见问题

回到代码再回来，画布还在吗

在。画布内容留在本机，「画布」按钮上会有个小圆点提示有内容。清空画布后就没有了。

改了代码，画布会跟着变吗

不会，这正是单向门的意思。要同步就在画布菜单里「用编辑器里的代码重新转入」，注意它会替换整个画布。

画布内容会上传吗

不会。转换与保存都在浏览器里完成；Excalidraw 的字体文件也从本站取，画布不请求任何第三方服务。素材库里的「浏览素材库」会打开 Excalidraw 的公开素材站，那是你主动跳过去挑素材，挑完会跳回这里。

手机上能用吗

能。入口在「下载」面板里的「转入自由画布…」，Excalidraw 在小屏上有自己的工具栏；细致的拖动还是桌面更顺手。