- 什么是 Mermaid,为什么使用基于文本的图表?
- Mermaid 是一个基于文本的图表工具,可以从类似 markdown 的语法生成图表。使用文本而不是图形编辑器提供关键优势:版本控制(图表可以像代码一样在 Git 中跟踪)、轻松协作(共享和编辑纯文本)、自动化(以编程方式生成图表)、一致性(主题确保统一样式)以及不需要专门的软件。它非常适合文档、技术写作和开发工作流程。
- 我可以使用 Mermaid 创建哪些类型的图表?
- Mermaid 支持多种图表类型:流程图(流程图、决策树)、时序图(系统交互、API 调用)、甘特图(项目时间线)、类图(UML 对象模型)、状态图(状态机)、ER 图(数据库模式)、饼图(比例数据)、用户旅程图(用户流程)和 Git 图(分支历史)。每种类型都有用于节点、连接和属性的特定语法。
- 如何导出图表以用于文档或演示文稿?
- 您可以导出多种格式的图表:SVG(可缩放矢量图形)用于任何尺寸的清晰渲染和在矢量工具中编辑、PNG(栅格图像)具有可自定义的分辨率用于嵌入文档、PDF 用于打印和共享,或直接复制 Mermaid 代码以嵌入 Markdown 文件、GitHub README、Notion 页面、GitLab wiki 或 Confluence 文档中,这些平台原生支持 Mermaid。
- 我可以自定义图表的外观吗?
- 可以,Mermaid 提供了丰富的自定义选项:内置主题(default、forest、dark、neutral)可更改整体配色方案。您可以使用 classDef 定义自定义 CSS 类并将其应用于节点。单个节点样式支持自定义形状、颜色、边框和字体。连接样式可以是实线、虚线或带可选标签的粗箭头。高级用户可以注入自定义 CSS 或使用主题变量来匹配品牌颜色和设计系统。
- Mermaid 在所有平台上都支持吗?
- Mermaid 在许多平台上得到原生支持,包括 GitHub、GitLab、Notion、Confluence、VS Code 和 Obsidian。对于不支持的平台,您可以将图表导出为 SVG 或 PNG 并作为图像嵌入。对于 Web 应用程序,您可以集成 Mermaid.js 库以启用客户端渲染。