日期与工期
选择 dateFormat，为任务设置开始、结束日期或工期。
项目时间线规划
Mermaid 甘特图在线编辑器
使用 Mermaid 甘特图语法规划带日期的发布计划。在上方编辑器中设置任务日期与工期、连接依赖并标记里程碑，再导出用于排期讨论。
在线创建 Mermaid 甘特图
下方发布示例结合阶段与 after 依赖。日期仅作演示，请根据自己的计划修改起始日期。
Loading diagram preview...
让日期与任务依赖容易核对
任务有日期、工期和依赖时，甘特图能表达排期。源码记录的是计划，不是实时任务跟踪或资源分配系统。
任务依赖
给前置任务稳定 ID，用 after 让后续任务在它结束后开始。
阶段与里程碑
用 section 分组，用 milestone 标记审批或交付节点。
状态与非工作日
标记 done、active 或 crit，需要时排除周末对工期的影响。
把发布计划转换为时间线
先表达明确的依赖，再增加会影响排期讨论的任务细节。
- 01
声明 gantt 与 dateFormat，添加阶段和第一个带日期的任务。
- 02
设置任务 ID，用 after 关联后续任务，按需添加里程碑与排除日期。
- 03
对照真实计划核对开始和结束日期，再导出用于文档或演示的时间线。
任务 ID、开始日期与工期
冒号后可依次写任务 ID、符合 dateFormat 的日期和工期。dateFormat 用于解析任务日期，axisFormat 用于展示坐标轴。
gantt
dateFormat YYYY-MM-DD
axisFormat %m-%d
section 设计
需求梳理 :req, 2026-09-01, 3d使用 after 表达依赖
引用前置任务的 ID，不是展示标题。前置任务结束时间改变时，使用 after 的后续任务会跟着移动。
gantt
dateFormat YYYY-MM-DD
section 交付
构建 :build, 2026-09-01, 5d
评审 :review, after build, 2d排除非工作日
excludes weekends 在任务工期计算中跳过周末。跨过排除日期的任务，日历上的结束日期可能延后。
gantt
dateFormat YYYY-MM-DD
excludes weekends
section 交付
构建 :build, 2026-09-04, 3d状态标签与里程碑
done、active、crit 和 milestone 写在任务 ID 之前。0d 里程碑表示单一时间点，crit 是人工标记，不是计算出的关键路径。
gantt
dateFormat YYYY-MM-DD
section 发布
构建 :done, build, 2026-09-01, 3d
评审 :crit, review, after build, 2d
上线 :milestone, launch, after review, 0dMermaid 甘特图示例
发布计划按设计和交付分组，需求、原型、实现和发布节点通过依赖相连，便于核对先后顺序。
gantt
title 产品发布计划
dateFormat YYYY-MM-DD
axisFormat %m-%d
section 设计
需求确认 :done, req, 2026-09-01, 3d
原型设计 :active, proto, after req, 4d
section 交付
功能实现 :dev, after proto, 7d
正式发布 :milestone, release, after dev, 0d- req、proto 和 dev 是供 after 引用的 ID，修改展示标题不必改变这些引用。
- done 和 active 是源码中指定的状态，不是从任务系统同步的进度。
- 尝试添加 excludes weekends，检查哪些结束日期移动，以及是否符合团队工作日历。
常见问题
为什么日期不能正确解析？
检查显式日期是否符合 dateFormat、元数据是否用逗号分隔，以及状态标签是否写在 ID 和日期之前。可统一采用 YYYY-MM-DD。
如何让一个任务在另一个任务之后开始？
为前置任务设置 ID，并写 after 加 ID，例如 评审 :review, after build, 2d。
3d 是否总表示三个日历日后结束？
不是。任务区间包含 excludes weekends 或其他排除日期时，这些日期不计入工期，日历结束时间可能延后。
crit 会自动计算关键路径吗？
不会。crit 是人工添加的任务标签，用于视觉标记；当前编辑器不承诺基于资源或依赖自动计算关键路径。
里程碑必须使用 0d 吗？
不必须。Mermaid 根据开始时间和工期确定里程碑位置。如果事件需要表示单一时间点，可使用 0d。
会自动同步任务跟踪系统吗？
当前页面根据 Mermaid 源码中的日期和状态渲染。计划变化后需要修改源码并重新导出，没有提供任务系统同步。
延伸阅读
比较 Mermaid 与 PlantUML
需要为技术文档选择图表语言时，了解两者的语法与建模能力差异。
阅读图表语言比较 →