Mermaid 时间线图 #

时间线图(Timeline)用于按时间顺序展示事件的发生过程,适用于历史记录、项目进度、个人经历等场景。

基本语法 #

Mermaid的时间线图使用timeline关键字定义:

mermaid
timeline
  时期1
    事件1
    事件2
  时期2
    事件3
    事件4

基本结构 #

1. 简单时间线 #

mermaid
timeline
  2023年
    学习Mermaid
    完成项目
  2024年
    学习新技能
    获得认证

2. 详细日期 #

可以包含更详细的日期信息:

mermaid
timeline
  2023年1月
    项目启动
    需求分析
  2023年2月
    系统设计
    数据库设计
  2023年3月
    前端开发
    后端开发
  2023年4月
    测试阶段
    项目交付

时期与事件 #

1. 按阶段划分 #

mermaid
timeline
  规划阶段
    项目立项
    需求调研
    制定计划
  开发阶段
    系统设计
    编码实现
    单元测试
  测试阶段
    集成测试
    系统测试
    用户验收测试
  上线阶段
    系统部署
    上线运营
    项目收尾

2. 历史事件时间线 #

mermaid
timeline
  古代
    公元前3500年:古埃及文明
    公元前221年:秦始皇统一中国
    公元476年:西罗马帝国灭亡
  近代
    1776年:美国独立宣言
    1789年:法国大革命
    1865年:美国南北战争结束
  现代
    1945年:第二次世界大战结束
    1969年:人类首次登月
    1989年:柏林墙倒塌
    2001年:互联网泡沫破裂

高级功能 #

1. 项目开发时间线 #

mermaid
timeline
  项目启动 (2023-01)
    项目立项
    组建团队
    需求分析
  系统设计 (2023-02)
    架构设计
    数据库设计
    界面设计
  前端开发 (2023-03)
    页面开发
    组件开发
    接口对接
  后端开发 (2023-03)
    API开发
    业务逻辑实现
    数据库实现
  测试阶段 (2023-04)
    单元测试
    集成测试
    系统测试
    用户验收测试
  上线运营 (2023-05)
    系统部署
    上线宣传
    运营监控

2. 个人成长时间线 #

mermaid
timeline
  教育经历
    2010-2013:高中
    2013-2017:本科
    2017-2020:硕士
  工作经历
    2020-2022:初级工程师
    2022-2024:中级工程师
    2024-至今:高级工程师
  技能提升
    2021:学习前端技术
    2022:学习后端技术
    2023:学习云计算
    2024:学习人工智能

3. 产品发布时间线 #

mermaid
timeline
  产品1.0
    2022-01:产品规划
    2022-03:原型设计
    2022-06:开发完成
    2022-07:正式发布
  产品2.0
    2022-10:需求收集
    2023-01:功能设计
    2023-04:开发完成
    2023-05:正式发布
  产品3.0
    2023-08:市场调研
    2023-11:架构升级
    2024-02:开发完成
    2024-03:正式发布

最佳实践 #

  1. 清晰的时间划分:按照合理的时间间隔划分时期
  2. 简明的事件描述:使用简洁的语言描述事件
  3. 一致的时间格式:保持时间格式的一致性
  4. 合理的时期数量:每个时间线的时期数量不宜过多
  5. 突出重要事件:对重要事件可以使用更详细的描述

常见应用场景 #

  1. 项目管理:展示项目的各个阶段和重要里程碑
  2. 历史记录:展示历史事件的时间顺序
  3. 个人简历:展示个人经历和成就
  4. 产品迭代:展示产品的版本迭代历史
  5. 学习计划:展示学习进度和目标完成情况
  6. 活动策划:展示活动的筹备和执行过程

替代实现方式 #

如果需要更丰富的时间线功能,可以考虑使用其他工具:

  1. Microsoft PowerPoint:使用SmartArt创建时间线
  2. TimelineJS:开源的交互式时间线库
  3. Prezi:支持创建动态时间线
  4. Tableau:数据可视化工具,支持时间线图表

完整示例 #

下面是一个完整的软件开发项目时间线示例:

mermaid
timeline
  项目启动 (2023-01)
    1月5日:项目立项会议
    1月10日:组建开发团队
    1月15日:完成需求收集
    1月20日:需求文档评审通过
  系统设计 (2023-02)
    2月1日:架构设计开始
    2月10日:数据库设计完成
    2月15日:API接口设计完成
    2月20日:UI/UX设计完成
    2月28日:设计文档评审通过
  开发阶段 (2023-03至2023-05)
    3月1日:开发工作启动
    3月15日:前端基础框架完成
    3月31日:后端核心功能完成
    4月15日:数据库实现完成
    4月30日:前后端集成完成
    5月15日:所有功能开发完成
  测试阶段 (2023-05至2023-06)
    5月20日:单元测试开始
    5月31日:集成测试开始
    6月10日:系统测试开始
    6月20日:用户验收测试开始
    6月30日:所有测试通过
  上线阶段 (2023-07)
    7月5日:预发布环境部署
    7月10日:压力测试完成
    7月15日:正式上线
    7月20日:上线后监控
    7月31日:项目验收完成
  运营与维护 (2023-08至今)
    8月10日:第一次版本迭代
    9月5日:第二次版本迭代
    10月15日:功能优化
    12月10日:年度总结会议
最后更新:2026-02-08