甘特图：todayMarker

简介 / Introduction

甘特图（Gantt Chart）是项目管理中常用的可视化工具，用于展示任务的时间安排和进度。todayMarker 是在甘特图中标注”今天”位置的标记线，帮助团队直观看到当前时间点与各任务之间的关系。本文分别用 PlantUML 和 Mermaid 两种语法实现这一功能。

PlantUML 版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

@startgantt
scale 2
Project starts 2026-09-01

[需求分析] lasts 3 days
[系统设计] lasts 2 days
[编码实现] lasts 5 days
[测试验收] lasts 2 days

then [部署上线]

-- 上线准备 --
[运维文档] lasts 2 days
[用户培训] lasts 1 days

yellow lasts 1 days
then [上线评审]

today 42
@enduml

说明：

• today 42 在甘特图中绘制一条红色垂直线，表示”今天”所在位置。
• PlantUML Gantt 支持 [任务名] lasts N days 定义任务时长。
• then 关键字表示任务顺序连接（前置任务完成后开始）。
• -- 分隔线用于分组任务阶段（如”上线准备”）。

Mermaid 版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

gantt
    title 项目里程碑
    dateFormat YYYY-MM-DD
    axisFormat  %m-%d

    section 设计阶段
    需求分析           :done,    des1, 2026-09-01, 3d
    系统设计           :active,  des2, after des1, 2d

    section 开发阶段
    编码实现           :         dev1, after des2, 5d
    测试验收           :         test1, after dev1, 2d

    section 上线
    部署上线           :         launch, after test1, 1d

    todayMarker

说明：

• Mermaid 用 todayMarker 关键字绘制”今天”标记线（蓝色虚线）。
• dateFormat 定义输入日期格式，axisFormat 控制横轴显示格式。
• done / active 等关键字表示任务状态（已完成 / 进行中）。
• section 分隔不同阶段的任务组。

对比 / Side-by-side

小结 / Wrap-up

PlantUML Gantt 的 today N 标记可自定义颜色，适合需要醒目强调”今天”的场景；Mermaid 的 todayMarker 是内置关键字，开箱即用，适合嵌入 Markdown 文档快速预览。两者都能清晰展示项目进度与当前时间的位置关系，可根据团队工具链选择合适方案。