Kroki支持哪些图表类型？

Question

**问题：** Kroki 支持哪些图表类型？在使用 Kroki 生成图表时，常见的支持格式有哪些？是否兼容主流的文本生成图表工具，如 Mermaid、PlantUML 或 Graphviz？是否支持 UML、流程图、时序图等常见开发图表类型？

Answer 1

一、Kroki 简介与支持图表类型概述

Kroki 是一个开源的图表渲染服务，它允许用户通过文本描述生成各种类型的图表。Kroki 的核心理念是将多种图表引擎集成到一个统一的 API 接口中，从而实现一站式图表生成。

它支持的图表类型包括但不限于：

• 流程图（Flowchart）
• 时序图（Sequence Diagram）
• 类图（Class Diagram）
• 状态图（State Diagram）
• 活动图（Activity Diagram）
• 甘特图（Gantt Chart）
• 饼图（Pie Chart）
• 柱状图（Bar Chart）
• 网络图（Network Graph）
• 架构图（Architecture Diagram）

二、Kroki 支持的常见图表格式

Kroki 支持多种文本格式来描述图表，这些格式通常与主流的图表生成工具兼容。常见的支持格式包括：

图表格式	对应引擎	说明
Mermaid	Mermaid.js	支持流程图、时序图、甘特图等多种开发常用图表
PlantUML	PlantUML	广泛用于 UML 图表，包括类图、时序图、用例图等
Graphviz	Graphviz (DOT)	适用于复杂的图结构，如流程图、依赖图等
WaveDrom	WaveDrom	用于生成时序波形图
Vega / Vega-Lite	Vega	用于生成交互式数据可视化图表

三、Kroki 与主流文本图表工具的兼容性分析

Kroki 的一大优势在于其兼容性。它通过集成多个后端引擎，实现了与以下主流文本图表工具的无缝集成：

• Mermaid： Kroki 支持 Mermaid 语法，允许用户使用 Mermaid 的 DSL（领域特定语言）生成流程图、时序图等。
• PlantUML： 对 PlantUML 的完整支持，包括 UML 图表（如类图、时序图、状态图等）。
• Graphviz： 支持 DOT 语言，适用于生成复杂的图结构。
• Diagrams.net（Draw.io）： 通过集成支持 XML 格式的图表导入。

这种兼容性使得 Kroki 成为一个统一的图表服务接口，用户无需在多个工具之间切换。

四、Kroki 支持的开发常用图表类型详解

Kroki 几乎涵盖了开发过程中所有常见的图表类型，具体包括：

1. UML 图表： 类图、对象图、组件图、部署图、用例图、状态图、活动图、时序图等。
2. 流程图（Flowchart）： 支持从左到右、从上到下的多种布局。
3. 时序图（Sequence Diagram）： 支持同步、异步消息，生命线等复杂交互。
4. 状态图（State Diagram）： 支持条件判断、子状态等高级功能。
5. 架构图（Architecture Diagram）： 如 C4 模型、4+1 视图模型等。
6. 数据可视化图表： 折线图、柱状图、饼图、散点图等。

例如，使用 Mermaid 语法生成一个流程图：

graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Process 1]
    B -->|No| D[Process 2]
    C --> E[End]
    D --> E
  

五、Kroki 的应用场景与技术实现

Kroki 可广泛应用于以下场景：

• 文档系统（如 Confluence、Notion、MkDocs）中嵌入图表
• CI/CD 流程中自动生成架构图或流程图
• API 文档中嵌入交互式图表
• 开发协作工具中集成图表生成能力

Kroki 的技术实现基于：

• 后端使用 Go 语言编写，提供高性能的 RESTful API。
• 前端通过 Web 组件集成，支持 Markdown 渲染器（如 Typora、Obsidian）。
• 图表渲染依赖于多个开源引擎，如 Mermaid.js、PlantUML、Graphviz 等。

其架构图如下所示：

graph LR
    A[用户输入] --> B[Kroki API]
    B --> C1[Mermaid Engine]
    B --> C2[PlantUML Engine]
    B --> C3[Graphviz Engine]
    C1 --> D[SVG/PNG 输出]
    C2 --> D
    C3 --> D