工具先生

使用方法

Mermaid 预览的使用方法

用于预览 Mermaid 图表的工具,适合在整理图表时快速试验语法,或确认规格说明图的显示效果。通过切换主题,也能在分享前比较输出外观。

Mermaid 预览 缩略图Mermaid 预览 缩略图

适用场景

适合在这些时候使用

  • 快速确认规格文档中的流程图
  • 尝试并微调时序图语法
  • 在写入文档前确认 Mermaid 图表外观
  • 在设计评审前快速整理时序图
  • 尝试 ER 图或甘特图的语法
  • 在分享给团队前确认图表外观

可实现内容

这个工具可以做什么

  • 并排查看 Mermaid 语法与图表
  • 切换主题
  • 确认语法错误并复制源码
  • 将图表保存或复制为 SVG 或 PNG
  • 在预览下方实时显示错误信息
  • 支持流程图、时序图、ER 图等主要图表类型

指南

各画面区域的使用方法

按画面区域说明设置、输入、预览、结果和保存等操作方法。

01 HOWTO

语法输入区域

在左侧输入 Mermaid 语法。可以先选择图表模板,再根据当前图表类型插入补全候选,并在右侧预览中确认结构。

显示 Mermaid 预览 的 语法输入区域 的画面显示 Mermaid 预览 的 语法输入区域 的画面

这个区域可以做什么

  • 可以直接输入 Mermaid 语法
  • 可以从模板插入图表基础结构
  • 可以追加符合当前图表类型的补全候选
  • 可以根据错误显示修正输入

操作位置

01
语法输入

可以输入流程图、时序图、类图等 Mermaid 语法。

显示在 Mermaid 预览 中使用 语法输入 的位置的画面显示在 Mermaid 预览 中使用 语法输入 的位置的画面
02
模板选择

输入为空时,可以选择图表类型并插入基础结构。

显示在 Mermaid 预览 中使用 模板选择 的位置的画面显示在 Mermaid 预览 中使用 模板选择 的位置的画面
03
输入补全候选

可以在光标位置插入节点、连接、分支等符合当前图表类型的候选。

显示在 Mermaid 预览 中使用 输入补全候选 的位置的画面显示在 Mermaid 预览 中使用 输入补全候选 的位置的画面
04
错误确认

语法有问题时,可以查看预览侧的显示并修正输入。

显示在 Mermaid 预览 中使用 错误确认 的位置的画面显示在 Mermaid 预览 中使用 错误确认 的位置的画面

02 HOWTO

输入补全和编辑辅助区域

使用输入框上方的模板和补全候选、顶部的历史记录,以及输入框右上角的清空和复制操作来编辑图表。这里用于创建基础结构、追加部件和复用草稿。

显示 Mermaid 预览 的 输入补全和编辑辅助区域 的画面显示 Mermaid 预览 的 输入补全和编辑辅助区域 的画面

这个区域可以做什么

  • 可以插入符合图表类型的模板
  • 可以追加符合当前图表的部件
  • 可以从历史记录恢复最近的编辑状态
  • 可以清空或复制当前语法

操作位置

01
模板

可以选择流程图、时序图、类图等基础结构并插入输入框。

显示在 Mermaid 预览 中使用 模板 的位置的画面显示在 Mermaid 预览 中使用 模板 的位置的画面
02
补全候选

可以追加节点、连接、分支、循环等符合当前语法的部件。

显示在 Mermaid 预览 中使用 补全候选 的位置的画面显示在 Mermaid 预览 中使用 补全候选 的位置的画面
03
历史记录和草稿

当前输入会作为草稿保存在浏览器中,也可以从历史记录回到最近的编辑状态。

显示在 Mermaid 预览 中使用 历史记录和草稿 的位置的画面显示在 Mermaid 预览 中使用 历史记录和草稿 的位置的画面
04
清空输入

可以删除当前语法并重新创建图表。

显示在 Mermaid 预览 中使用 清空输入 的位置的画面显示在 Mermaid 预览 中使用 清空输入 的位置的画面
05
复制语法

可以将编辑中的语法复制到 README 或规格文档。

显示在 Mermaid 预览 中使用 复制语法 的位置的画面显示在 Mermaid 预览 中使用 复制语法 的位置的画面

03 HOWTO

预览和主题区域

在右侧预览栏确认 Mermaid 的绘制结果,并在分享前切换主题。无法绘制时,错误内容也会显示在这里。

显示 Mermaid 预览 的预览和主题区域的画面显示 Mermaid 预览 的预览和主题区域的画面

这个区域可以做什么

  • 可以切换预览主题
  • 可以确认图形绘制结果
  • 可以查看绘制错误
  • 可以回到输入栏修正语法

操作位置

01
切换主题

可以改变背景和线条颜色,选择适合共享位置的显示效果。

显示 Mermaid 预览 中 切换主题 操作位置的画面显示 Mermaid 预览 中 切换主题 操作位置的画面
02
确认图形

可以确认输入的 Mermaid 语法是否绘制成预期图形。

显示 Mermaid 预览 中 确认图形 操作位置的画面显示 Mermaid 预览 中 确认图形 操作位置的画面
03
确认错误

无法绘制时,先查看错误消息再修正语法。

显示 Mermaid 预览 中 确认错误 操作位置的画面显示 Mermaid 预览 中 确认错误 操作位置的画面
04
修改输入

可以参考预览结果,回到编辑器调整语法。

显示 Mermaid 预览 中 修改输入 操作位置的画面显示 Mermaid 预览 中 修改输入 操作位置的画面

04 HOWTO

输出格式、复制和下载区域

使用预览上方的输出操作选择 SVG 或 PNG,并复制或下载绘制好的图。无法输出时,可查看错误并返回输入栏修正。

显示 Mermaid 预览 的 输出格式、复制和下载区域 的画面显示 Mermaid 预览 的 输出格式、复制和下载区域 的画面

这个区域可以做什么

  • 可以选择 SVG / PNG 输出格式
  • 可以将绘制好的图作为图片复制
  • 可以将绘制好的图下载为文件
  • 可以复制原始 Mermaid 语法
  • 无法输出时可以确认错误

操作位置

01
输出格式

可在 SVG 和 PNG 之间切换,选择适合共享或粘贴位置的格式。

显示在 Mermaid 预览 中使用 输出格式 的位置的画面显示在 Mermaid 预览 中使用 输出格式 的位置的画面
02
复制图片

可以按当前选择的格式复制绘制好的图,并粘贴到文档或聊天中。

显示在 Mermaid 预览 中使用 复制图片 的位置的画面显示在 Mermaid 预览 中使用 复制图片 的位置的画面
03
下载图片

可以将绘制好的图保存为 SVG 或 PNG 文件。

显示在 Mermaid 预览 中使用 下载图片 的位置的画面显示在 Mermaid 预览 中使用 下载图片 的位置的画面
04
复制语法

可以复制生成图形所用的 Mermaid 语法,并与图片一起共享。

显示在 Mermaid 预览 中使用 复制语法 的位置的画面显示在 Mermaid 预览 中使用 复制语法 的位置的画面
05
确认错误

无法输出图形时,可以查看错误并返回输入栏修正。

显示在 Mermaid 预览 中使用 确认错误 的位置的画面显示在 Mermaid 预览 中使用 确认错误 的位置的画面

注意事项

注意事项

将使用前应先判断的重要点按原因归纳整理。

确认事项

先从能渲染的最小语法开始

如果一次加入太多元素,错误原因会更难定位。建议先从最小可用语法开始,再逐步增加节点或分支。

确认事项

切换主题以确认线条与文字可见性

即使是同一份 Mermaid 语法,不同主题下的背景与线条颜色也会不同。使用接近最终展示环境的主题,可减少返工。

注意

语法错误显示在预览下方

语法有误时,预览区域会显示错误信息。图表未能显示时,请先查看错误信息,修正语法后再试。

FAQ

关于 Mermaid 预览 的常见问题

这里先整理能帮助使用前判断的常见问题。

可以把图表保存成图片吗?

可以。支持 SVG 与 PNG,并提供复制与下载操作。

在哪里查看语法错误?

错误信息会显示在预览下方,编辑时可立即定位有问题的部分。

支持哪些图表类型?

支持流程图、时序图、类图、ER 图、甘特图等 Mermaid 标准支持的图表类型。

在哪里可以查看语法说明?

Mermaid 官方文档中有各类图表的语法说明。可以在本页边写语法边确认效果。

可以更改图表背景色吗?

切换主题可改变包括背景色在内的整体样式。可以比较不同主题下的显示效果。

如何将图表以图片形式分享?

可保存为 SVG 或 PNG 后分享,也支持复制到剪贴板。

下一步指南

相关指南

这里整理了相关指南,便于继续操作时不迷失。