甘特图

语法

gantt
    %注释
    title 这是标题
    
    %输入数据的时间格式
    dateFormat YYYY-MM-DD
    
    %坐标轴的时间格式
    axisFormat %m-%d
    
    %排除的时间
    excludes weekends
    
    %坐标轴刻度，高版本支持
    tickInterval 1day

    %是否显示当天的标记，默认on
    todayMarker off
    
    section 项目A
        %任务描述 : [任务状态,] [任务名称,] 开始时间, 时长或结束时间
        任务1 : done, a1, 2023-03-01, 3d
        任务2 : active, a2, after a1, 2023-03-08
        里程碑 : milestone, a3, 2023-03-07, 1d
    section 项目B
        任务1 : b1, 2023-03-07, 4000m
        任务2 : crit, b2, after a2, 15h

gantt
    %注释
    title 这是标题
    dateFormat YYYY-MM-DD
    axisFormat %m-%d
    excludes weekends
    %tickInterval 1day
    todayMarker off
    
    section 项目A
        任务1 : done, a1, 2023-03-01, 3d
        任务2 : active, a2, after a1, 2023-03-08
        里程碑 : milestone, a3, 2023-03-07, 1d
    section 项目B
        任务1 : b1, 2023-03-07, 4000m
        任务2 : crit, b2, after a2, 15h

输入数据的时间格式

关键字dateFormat后的内容用于声明输入数据的时间格式，具体如下：

标记	含义
YYYY	四位年
YY	两位年
M	无0补齐的月
MM	两位的月
D	无0补齐的日
DD	两位的日
H	无0补齐的时，24小时制
HH	两位的时，24小时制
h	无0补齐的时，12小时制
hh	两位的时，12小时制
m	无0补齐的分
mm	两位的分
s	无0补齐的秒
ss	两位的秒
Z ZZ	UTC时区

坐标轴的时间格式

关键字axisFormat后的内容用于声明坐标轴的时间格式，具体如下：

标记	含义
%Y	四位年
%y	两位年
%m	两位月
%d	0补齐的两位日
%e	空格补齐的两位日
%H	两位的时，24小时制
%I	两位的时，12小时制
%M	两位的分
%S	两位的秒

坐标轴刻度

关键字tickInterval后的内容用于设定坐标轴的时间刻度，由数字+单位组成：

单位	含义
minute	分钟
hour	小时
day	天
week	周
month	月

排除的时间

关键字excludes后的内容用于设定排除的时间，weekends表示周末，多个时间用逗号,或空白 分隔。

任务状态

状态	含义
done	已完成
active	激活，进行中
无	默认，未开始
crit	关键任务，可与其它叠加使用

里程碑

关键字milestone声明的任务为里程碑，实际显示的位置为任务时间段的正中间。