# Mermaid 甘特图速查表

任务、阶段和日期，沿着时间轴排开。

## 阶段与任务

任务是标题、一个冒号，然后是开始时间和长度。dateFormat 说明日期怎么读。

```mermaid
gantt
  dateFormat YYYY-MM-DD
  title Release plan
  section Build
  Compile :a1, 2026-01-06, 3d
  Test    :a2, after a1, 5d
```

![一张甘特图，有一个叫 Build 的阶段，里面有两根先后相接的横条。](/diagrams/gantt/tasks.svg)

## 状态标签

done、active 和 crit 都是标签，而且必须写在清单最前面。

```mermaid
gantt
  dateFormat YYYY-MM-DD
  section Build
  Compile :done, a1, 2026-01-06, 3d
  Test    :active, a2, 2026-01-09, 3d
  Ship    :crit, a3, 2026-01-12, 2d
```

![一个阶段里的三根甘特条：第一根填充，第二根只有轮廓，第三根高亮成红色。](/diagrams/gantt/status.svg)

## 依赖另一个任务

after a1 表示这个任务在 id 为 a1 的那个结束时开始。

```mermaid
gantt
  dateFormat YYYY-MM-DD
  section Build
  Compile :a1, 2026-01-06, 3d
  Test    :a2, after a1, 5d
  Ship    :a3, after a2, 2d
```

![一排三根甘特条，每一根都从前一根结束的地方开始。](/diagrams/gantt/dependencies.svg)

## 里程碑

里程碑是长度为零的任务——是时间轴上的一个标记，不是一根横条。

```mermaid
gantt
  dateFormat YYYY-MM-DD
  section Release
  Work :a1, 2026-01-06, 10d
  Launch :milestone, m1, 2026-01-20, 0d
```

![一根表示工作的甘特条，右端有一个菱形标记表示发布。](/diagrams/gantt/milestone.svg)

## 在 Mernyx 里画出来

打开一个 .mmd 文件，在画布上挪一个节点，源码跟着走。macOS 原生，不经过浏览器。