工作流

在 Slack 中创建和编辑 Mermaid 图表

Slack 本身不会渲染 Mermaid。使用 Arialine,你可以自己编写 Mermaid——输入 /arialine 并粘贴,它会完全按原样渲染,无需 AI——也可以用自然语言描述图表,让 Arialine 编写源代码。无论哪种方式,图表都会以 PNG 和交互式 HTML 文件的形式出现在 Slack 中,队友只需在消息列中回复即可修改,无需从头再来。

1问题

Mermaid 在 Slack 中的问题

  • Slack 把 Mermaid 显示为纯代码——看不到的图表没人会去评审。
  • 截取本地 Mermaid 预览会丢失源码,之后就没人能再修改。
  • 单独一张 PNG 无法说明哪份源码是最新的,也无法说明是哪次讨论导致了修改。
  • Slack 会转义消息中的 > 和 & 等字符,复制代码时 -->> 这类箭头会悄悄失效。
2Arialine 的解决方式

在 Slack 中制作 Mermaid 图表的两种方式

  1. 1

    自己编写:粘贴你的 Mermaid

    输入 /arialine 后接你的 Mermaid,或只输入 /arialine 打开 New diagram 表单。也可以在提及 @arialine 时附上 ```mermaid 代码块,或分享 .mmd 文件。有效的 Mermaid 会按原样渲染,不调用 AI 模型。

  2. 2

    直接描述:让 Arialine 编写源代码

    在同一表单中写一句话,或提及 @arialine:“带重试队列、三次失败后进入死信队列的结账流程”。Arialine 会编写 Mermaid、进行校验并发布图表。源代码随时可以查看和导出。

  3. 3

    发布前先校验

    每张图表都会先经过渲染器校验。有错误的 Mermaid 会由 AI 自动修复(或提供一键修复卡片)——出错的图表绝不会被发布。

  4. 4

    消息列中的可交互 HTML + PNG

    在桌面端你会得到可平移缩放的交互式 HTML 文件,其他场景则是 PNG。源码始终附在看板上,可随时导出为 .mmd、PNG 或 SVG。

  5. 5

    无需从头再来即可修改

    队友在图表消息列中回复——“@arialine add a fraud check before payment”——Arialine 会修改现有源代码,而不是重新画一张图。每次修改都是一个带编号的版本,附带 Undo、Rewind 以及指向提出修改的那条消息的链接。

3直接使用你已有的源码

粘贴 Mermaid,随时可编辑

粘贴 Mermaid 代码块或上传 .mmd,然后使用 Render as diagram。是否自动渲染取决于频道设置。在请求具体修改之前,请先检查已发布的图表和源码。

看板会保留可编辑的 Mermaid。可将源码导出为 .mmd,或将渲染图导出为 PNG 或 SVG;在提议模式下,应用修改前请先审核。

Arialine 的 Mermaid 源码窗口,可编辑图表源码
可将源码导出为 .mmd,或将渲染图导出为 PNG 或 SVG。
4你将得到什么

图表直接发布在频道中

Arialine 会回复一个看板:渲染好的 PNG、可缩放和拖动的交互式 HTML 文件,以及 History、Branch 和 Export 控件。后续版本会出现在其下方的消息列中。

几分钟即可完成设置

  1. 1点击 Add to Slack,为你的工作区批准 Arialine(可能需要管理员批准)。
  2. 2将它邀请到频道:输入 /invite @Arialine。
  3. 3输入 /arialine,粘贴你的 Mermaid 或描述图表,然后点击 Create。
  4. 4在图表消息列中用 @arialine 回复一项修改,即可生成版本 2。
Arialine 在 Slack 中发送的一条消息:包含渲染好的 checkout-review 图表、History 和 Branch 按钮、Export 菜单以及交互式 HTML 文件
FAQ

常见问题

Slack 支持 Mermaid 图表吗?+

不支持原生渲染:Slack 会把 Mermaid 显示为代码块,需要 Slack 应用来渲染。Arialine 会渲染你粘贴或分享的 Mermaid,并将结果以 PNG 和交互式 HTML 文件的形式发布到频道。

Slack 最好的 Mermaid 集成是什么?+

如果你只需要一张一次性的图片,简单的渲染工具就够了。如果图表会不断变化,Arialine 正是为此而生:它无需 AI 即可渲染粘贴的 Mermaid,能根据自然语言生成 Mermaid,并把每次修改连同背后的 Slack 消息一起保存为版本。

我需要懂 Mermaid 语法吗?+

不需要。你也可以直接用自然语言描述图表——@arialine 会替你写 Mermaid。粘贴现成的 Mermaid 则会跳过 AI,直接渲染。

支持哪些 Mermaid 图表类型?+

Mermaid 12 的所有类型以及 ZenUML:flowchart, sequence, class, state, ER, C4, Gantt, pie, mindmap, timeline, Git graph, user journey, quadrant, requirement, Sankey, XY chart, block, packet, kanban, architecture, radar, treemap, swimlane, use case, event modeling, Venn, Ishikawa (fishbone), Wardley map, Cynefin, tree view, railroad, agent flow。PNG、交互式 HTML 和 PDF 绘制的类型完全一致。

它与 Mermaid Preview 有什么不同?+

Arialine 能做 Mermaid Preview 能做的一切——斜杠命令、粘贴 Mermaid、在频道中发布渲染好的图表——而且做得更好:它还会发布交互式 HTML、保存源代码、让队友在消息列中修改图表、保存每个版本,并能根据描述编写 Mermaid。

AI 模型宕机时还能渲染吗?+

可以——有效的 Mermaid 会直接渲染,不经过模型,因此即使 LLM 故障也能正常渲染。

在你的工作区中试用

Free 包含全部功能,每个工作区最多 3 个看板、每天 10 次 AI 生成。无需模型的操作不消耗每日额度。可能需要工作区管理员批准。