Markdown绘制甘特图教程

日常工作中多个项目并行推进时，很难描述清楚每个任务的进度，以及当前状态。之前也想过用甘特图来管理项目进度，但是绘制甘特图的成本太高，而且不容易掌握。很难在团队中推广普及。

最近在使用Markdown排版时，发现Markdown可以快速便捷的生成甘特图，且能满足日常工作需求。

下面用一个简单的实例，简单讲解Markdown mermaid甘特图的绘制与使用。

该教程主要包括以下几个部分：

1、选择工具（使用印象笔记或Typora编制甘特图）
2、mermaid常用关键写说明
3、将甘特图转换为PDF或html格式
4、打印甘特图
5、附甘特图实例代码

1、选择工具

市面上Markdown编辑器不少（比如：MarkdownPad、cmd markdown、有道笔记、简书、印象笔记、Typora等等），但是支持mermaid语法的很少。

这几个里边也就印象笔记、Typora支持甘特图。下面附上下载链接。

Typora
印象笔记

印象笔记支持左侧编辑右侧实时显示结果，Typora也可以支持实时显示结果，但结果与代码在一个视图中显示，不便于查看。

推荐使用印象笔记编制甘特图，使用Typora渲染甘特图，导出其它格式。

印象笔记——甘特图实例.png

2、mermaid关键字说明

详细教程请参照官方教程及示例。

mermaid官方教程

mermaid除了绘制甘特图之外，还可以绘制流程图、序列图、统计图表等，下面开始对常用关键字进行说明。

使用印象笔记中的插入甘特图按钮插入一个简单的甘特图实例。

一个最简单的甘特图

mermaid：图中红框第一行内容与最后一行内容，表示当前使用的语言为mermaid。
gantt：表示图表类型为甘特图
dateFormat：指定日期格式（Y表示年，M表示月，D表示日）。YYYY-MM-DD（2019-03-14），YY-MM-DD(19-03-14)
section： 项目关键字，空格之后输入项目名称。
任务行： section后每一行为一个任务。第一个字符串为任务名称，之后以:开头，添加任务属性。

接下来用下面代码实例说明常见任务属性。
任务状态：

• done 已完成
• active正在进行
• crit 关键任务
• 默认任务都为待完成状态

任务描述：在des1、des2位置添加任务描述，其它任务引用时直接引用des1就可以。
after: 描述任务时间关系。des3, after des2表示des3紧跟在des2之后。
任务时长有三种方式：

• 时间范围 如：2014-01-06,2014-01-08
• 指定天数 如：5d
• 指定开始日期+天数 如：2014-01-06，5d

**PS:所有关键字之间用“,”分隔，关键字需要属性时用空格分隔(如：after des2,)。