Mermaid 文本绘图:几行文字画出 20 多种图表,改文字即改图
【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaid
Mermaid 是一个开源的文本绘图工具:用几行类 Markdown 的文本,就能渲染出流程图、时序图、甘特图等 20 多种图表。写技术文档的、排项目进度的、以及想把想法快速变成示意而不碰设计软件的人,都适合用它。
Mermaid 文本绘图能胜任的三类场景
流程图:三行文字描述"谁做什么、下一步是什么",就得到一张带箭头的流程。改动其中一行,整张图跟着更新,适合技术文档里那种经常要修订的流程。
甘特图:写上任务开始日期、时长和先后依赖,排期表直接画出来;还可以声明哪些天不算工作日,时间轴自动顺延,做项目计划时很省事。
ER 图:用文字列出实体和它们之间的关系,得到一张数据库结构图。评审会上临时想看表结构时,比打开建模工具快。
第一次 Mermaid 绘图的最短路径
- 在浏览器打开官方在线编辑器,页面分成代码、配置、预览三个区域。
- 在左侧输入区写两行文字,例如:
graph TD A[开始] --> B[完成]- 右侧立刻渲染出图表;满意后直接导出 PNG 或 SVG。整个过程不到三分钟。
在线编辑器:代码、配置、预览在同一页面完成
Mermaid 进阶用法:三个最常被用到的设置
甘特图里怎么跳过周末
在甘特图定义中加一行excludes weekends,所有任务就会自动避开周六周日;也可以指定具体日期排除。长周期项目建议整段排除周末,时间轴更接近真实工期,详见甘特图文档。
排除周末后,甘特图在周末留出空档,任务顺延
一行配置换图表风格
内置五种主题:default、neutral(黑白,适合打印)、dark(深色背景)、forest(绿色系)、base(可在其基础上自定义变量)。文档要打印时,一行配置把整份文档的图切成 neutral 即可,做法见主题配置。
把图写进 Markdown 文件
图表文本以 mermaid 代码块放进 .md 文件,随代码一起进仓库。改动哪个节点,diff 里看得清清楚楚,这也是很多团队选 Mermaid 的关键原因:图不会悄悄过期。
Mermaid 新手的两个误区与能力边界
误区一:以为要先背完 20 多种图的语法才能上手。它们其实共用一个套路——首行声明图的类型,后面逐行列出元素和关系。先只写熟一种图,用到别的再查。
误区二:以为能像设计工具那样自由拖拽元素。Mermaid 的布局是渲染器自动生成的,你可以通过配置控制方向和间距,但无法逐像素调整每个元素的位置;需要精细排版时,传统绘图工具更合适。
想今天就画第一张图,可以从上面三行文字起步;完整语法都写在语法参考里。上手之后,就回不去了。
【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaid
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考