Graphviz DOT 图表生成器使用指南：语法规则、常见陷阱与代码示例

graphviz by markdown-viewer/skills

103 周安装量

7 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/markdown-viewer/skills --skill graphviz

数据可视化图表工具技术文档

🇨🇳中文介绍

Graphviz DOT 图表生成器

重要提示： 使用 dot` 作为代码围栏标识符，而不是 graphviz`。

快速开始： 选择 digraph（有向图）或 graph（无向图）→ 定义带属性（形状、颜色、标签）的节点 → 使用 -> 或 -- 连接 → 设置布局（rankdir, spacing）→ 用 ````dot 围栏包裹。默认：从上到下（rankdir=TB），集群名称必须以 cluster_` 开头，使用分号。

关键语法规则

规则 1：集群命名

❌ subgraph backend { }      → 不会渲染为方框
✅ subgraph cluster_backend { }  → 必须以 cluster_ 开头

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

规则 2：带空格的节点 ID

❌ API Gateway [label="API"];    → 无效的 ID
✅ "API Gateway" [label="API"];  → 为 ID 加上引号
✅ api_gateway [label="API Gateway"];  → 使用下划线 ID

规则 3：边语法的区别

digraph: A -> B;   → 有向箭头
graph:   A -- B;   → 无向线

规则 4：属性语法

❌ node [shape=box color=red]    → 缺少逗号
✅ node [shape=box, color=red];  → 用逗号分隔

规则 5：HTML 标签

✅ 使用 shape=plaintext 用于 HTML 标签
✅ 使用 < > 而不是 " " 来包裹 HTML 内容

问题	解决方案
节点重叠	增加 `nodesep` 和 `ranksep`
布局不佳	更改 `rankdir` 或添加 `{rank=same}`
边交叉	使用 `splines=ortho` 或调整节点顺序
集群未显示	名称必须以 `cluster_` 开头
标签未显示	检查引号转义

```dot
digraph G {
    [图表代码]
}
```

如需高级布局控制和复杂样式，请参考以下参考资料：

syntax.md — 布局控制（rankdir, splines, rank）、HTML 标签、边样式、集群子图以及基于记录的节点

2026 年 1 月 31 日

🇺🇸English

Graphviz DOT Diagram Generator

Important: Use dot` as the code fence identifier, NOT graphviz`.

Quick Start: Choose digraph (directed) or graph (undirected) → Define nodes with attributes (shape, color, label) → Connect with -> or -- → Set layout (rankdir, spacing) → Wrap in ````dot fence. Default: top-to-bottom (rankdir=TB), cluster names must start with cluster_`, use semicolons.

Critical Syntax Rules

Rule 1: Cluster Naming

❌ subgraph backend { }      → Won't render as box
✅ subgraph cluster_backend { }  → Must start with cluster_

Rule 2: Node IDs with Spaces

❌ API Gateway [label="API"];    → Invalid ID
✅ "API Gateway" [label="API"];  → Quote the ID
✅ api_gateway [label="API Gateway"];  → Use underscore ID

Rule 3: Edge Syntax Difference

digraph: A -> B;   → Directed arrow
graph:   A -- B;   → Undirected line

Rule 4: Attribute Syntax

❌ node [shape=box color=red]    → Missing comma
✅ node [shape=box, color=red];  → Comma separated

Rule 5: HTML Labels

✅ shape=plaintext for HTML labels
✅ Use < > not " " for HTML content

Common Pitfalls

Issue	Solution
Nodes overlapping	Increase `nodesep` and `ranksep`
Poor layout	Change `rankdir` or add `{rank=same}`
Edges crossing	Use `splines=ortho` or adjust node order
Cluster not showing	Name must start with `cluster_`
Label not displaying	Check quote escaping

Output Format

```dot
digraph G {
    [diagram code]
}
```

Related Files

For advanced layout control and complex styling, refer to references below:

syntax.md — Layout control (rankdir, splines, rank), HTML labels, edge styles, cluster subgraphs, and record-based nodes

Weekly Installs

Repository

markdown-viewer/skills

GitHub Stars

First Seen

Jan 31, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode81

gemini-cli80

github-copilot80

codex79

kimi-cli77

amp77

Claude技能创建器指南：构建模块化AI技能包，优化工作流与工具集成

5,700 周安装