企业官网建设流程全解析

使用 Mermaid Timeline 图绘制科研时间线：scientific-agent-skills 中 markdown-mermaid-writing 技能实战指南

【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000+ scientists worldwide. 165 ready-to-use validated skills plus 100+ scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills

时间线（Timeline）是 Mermaid 24 种图表类型中专门用于表达"按时间顺序发生的事件"的图型。本文以scientific-agent-skills仓库中 markdown-mermaid-writing 技能的 Timeline 图类型参考 文档为核心，完整讲解timeline语法的适用场景、无障碍性要求、示例与模板，并结合仓库内的样式指南、示例研究报告与组合图模式，给出可直接复制运行的完整代码块。读完本文，你将掌握用 Mermaid timeline 表达实验里程碑、发布历史、学术时间线等时序信息的完整方案。

Timeline 是什么：语法关键字与适用边界

在scientific-agent-skills中，markdown-mermaid-writing技能将 Mermaid 确立为"文本优先"的科学文档标准：一张以 Mermaid 形式内嵌在.md文件里的关系图，比任何静态图片都更有价值——它在 git 中可以干净地 diff、无需构建步骤、能在 GitHub/GitLab/Notion/VS Code 中原生渲染、比同等信息的散文消耗更少的 token，并且可以随时转换为精美图片（详见 SKILL.md）。

Timeline 是这套体系中的一员。其核心定义如下：

⚠️无障碍性（Accessibility）：Timeline不支持accTitle/accDescr。务必在代码块正上方放置一段描述性的斜体Markdown 段落，供屏幕阅读器与 AI 理解图意。

这一"不支持无障碍注解"的特征在 Mermaid 样式指南 中有完整罗列：不支持的图型包括 Mindmap、Timeline、Quadrant、Sankey、XY Chart、Block、Kanban、Packet、Architecture、Radar、Treemap，统一的对策就是"在代码块上方写斜体描述段落"。

何时选 Timeline：与 Flowchart、Gantt 的边界

技能文档反复强调一条原则："Pick the right type, not the easy type."（选择正确的图型，而不是最容易的图型）——不要所有场景都用 Flowchart 兜底。

从 Markdown 样式指南的图表选择表 与 Mermaid 样式指南的选择表 可以看出三种易混淆场景的边界：

三者的判断要点：

• Timeline 关注"什么时候发生了什么"——它不表达持续时长，也不表达任务之间的依赖，只按时间轴罗列事件；
• Gantt 关注"每项任务占多久、谁依赖谁"——它需要dateFormat、after taskId依赖语法、:milestone里程碑和:crit关键路径标记；
• Flowchart 关注"逻辑流向与分支"——与时间轴无关。

例如描述"一篇论文从投稿到见刊的审稿流程"用 Timeline 合适；而"这个月要排期完成的 8 个开发任务及依赖"则应改用 Gantt。技能在 mindmap.md、user_journey.md、kanban.md 等文件中也以 "When NOT to use" 交叉引用的方式互相锚定，保证了整库图型选择的一致性。

基础语法结构：title、section 与冒号分隔条目

Timeline 的核心语法由三部分组成：

1. timeline：声明图表类型的关键字；
2. title：图表标题，建议用 emoji 前缀做视觉锚点；
3. section：按年份、季度或阶段分组的时间段；
4. 条目行：每条事件名 : 细节一 : 细节二，同一个时间点可以用冒号分隔多个并列条目。

示例图：初创公司增长里程碑

以下示例图完整复现自 timeline.md，演示了按年份与季度组织事件的标准写法：

初创公司从创立到 A 轮融资的增长里程碑，按年份与季度组织：

模板：可直接套用的空骨架

写作时建议从模板出发，先搭出骨架再填充内容：

对时间线及所覆盖时间段的描述：

关键使用技巧（Tips）

timeline.md 给出的技巧是实战中最直接的规则，必须逐条落实：

• 用section按年份、季度或阶段分组——分组的粒度决定了时间线的可读性；
• 每个条目可以有多个事项，用:分隔——一个时间点可同时表达 2～3 个并列事件；
• 条目保持简洁——每条 2～4 个词——时间线的信息密度靠并列条目实现，而不是靠冗长文字；
• 在关键条目开头使用 emoji 作为视觉锚点——如 💡 创立、🧪 Beta、💰 融资，读者扫一眼 emoji 即可抓住叙事主线；
• 务必在图上配一段 Markdown 文字描述（通常为斜体段落），供屏幕阅读器理解。

结合 Mermaid 样式指南的 emoji 规则，emoji 使用还有四条附加约束：放置在标签开头、每个节点最多一个、同一 emoji 在全项目内语义必须一致、仅用于需要视觉区分的关键节点，并禁止使用 🎉 💯 🔥 等纯装饰性 emoji。例如💰只表示"金融/成本/计费"，🧪只表示"实验/测试/QA"。

复杂示例：把架构演进写成"讲故事"的时间线

当时间线跨越多年、承载业务指标与技术里程碑时，可以借鉴复杂示例的结构——把section当作"时代"而非"年份"来使用。以下完整复现自 timeline.md：

多年代技术平台演进：追踪一家初创公司从单体架构走向微服务、最终成为 AI 驱动平台的历程。六个 section 横跨 2020-2025 年，每个 section 记录驱动架构决策的关键技术里程碑与业务指标：

为什么这个写法有效（Why this works）

原文档对该复杂示例给出了四条经验总结，值得逐条内化：

1. 6 个 section 是"时代"而非简单年份——"Monolith Era""Breaking Apart""Microservices"讲的是架构为什么要变，而不只是什么时候变。section 名称本身就是叙事；
2. 业务指标与技术里程碑并列——用户数与团队规模紧挨着架构决策出现（50K 用户 → 触顶 → 拆服务），直观呈现驱动每次演进的"压力"来源；
3. 每个时间点塞入多个条目——每个季度用:分隔 2～3 个事件，形成信息密集但可扫读的并行视图；
4. emoji 锚定扫读路径——视线会先落在 🧠 ML、🌐 Multi-region、⚡ Redis 上，再读文字；快速浏览时仅凭 emoji 就能读懂整个故事。

仓库实战：在科研报告中落地 Timeline

timeline并不只是演示代码——技能自带的一篇完整科研报告 example-research-report.md 中，就有一个真实的 CRISPR 基因编辑实验里程碑时间线。它演示了科研场景的标准用法：以"月"为 section 粒度，每个 section 内并列两条实验进度：

注意这个示例与参考文档示例的一个差异：它在timeline之后、title之前写入了accTitle与accDescr。这实际上提示了兼容性问题——根据 Mermaid 样式指南，Timeline 并不支持无障碍注解，更稳妥的做法仍是"斜体段落 + 纯 timeline 语法"（参考文档示例图的写法），以保证在 GitHub 及各类渲染器上的行为一致。这也说明：以参考文档为语法权威、以示例报告为内容灵感，是使用该技能最可靠的组合方式。

从报告整体结构看（该示例同时使用了xychart-beta柱状图、gantt、flowchart、sequenceDiagram等图型），Timeline 被定位为"研究方法章节的时序骨架"，与量化图表各司其职——这正是技能倡导的"让每种关系都落到最匹配的图型上"。

与其他图型的组合编排

单一时间线只能表达一个视角。当文档需要同时服务管理层与工程师时，可以参考 complex_examples.md 的组合模式。其中与 Timeline 直接相关的组合包括：

技能文档对文献综述场景给出的具体建议是："用 Mindmap 绘制文献版图，用 Timeline 或 Gantt 展示发表时间线，用 Quadrant 或 Radar 对比方法论，用 Sequence 或 Flowchart 绘制论文中描述的数据流。"这意味着：时间线在综述类文档中的典型角色，是呈现某个领域或某条研究线的"演化史"——与 Timeline 图"Chronological events / history"的定位完全吻合。

写入文档前的检查清单

结合 timeline.md 与 Mermaid 样式指南的 Quality Checklist，每个 timeline 图在提交前应通过以下检查：

• 代码块正上方有描述性的斜体Markdown 段落（因 Timeline 不支持accTitle/accDescr）；
• section按年份、季度或阶段分组，粒度一致；
• 每个条目 2～4 个词，多个事项用:分隔且不过载；
• emoji 来自 样式指南的批准集，每条最多一个、置于开头、全库语义一致；
• 无%%{init}主题指令、无内联style（以保证 GitHub 深色模式正常渲染）；
• 时间轴形态为"事件罗列"而非"任务依赖/时长"，后者请改用 Gantt 图；
• 图型选择正确：确认 Flowchart、Sequence、Gantt 均不是更贴切的表达；
• 图表内联放置在相关文字旁，而不是集中堆在文末的独立 "Figures" 章节。

完成以上检查后，将.md文件（内嵌 Mermaid 源码）直接提交即可——文本源码即真相来源（source of truth），后续如需出版级配图，可再以该源码为 brief 交给 scientific-schematics 生成 PNG 作为补充图，实现"Phase 1 文本定稿、Phase 3 视觉精修"的三阶段工作流。

【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000+ scientists worldwide. 165 ready-to-use validated skills plus 100+ scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills