尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

Mermaid 图表生成工具:3 条命令搞定安装配置与上手全指南

Mermaid 图表生成工具:3 条命令搞定安装配置与上手全指南 Mermaid 图表生成工具3 条命令搞定安装配置与上手全指南【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaidMermaid 是一个文本驱动的图表生成工具用几行类似 Markdown 的文字就能产出流程图、序列图、甘特图、类图等几十种图表。它解决的是文档里的图永远是过期的这个痛点图即文本跟着代码一起进版本库、一起评审。写技术文档、画架构、排项目计划的开发者和产品经理都适合它。先睹为快文字变成图有多快不聊安装先看它能干什么。下面这段 6 行文字浏览器里直接就是一张可交互的流程图长这样更夸张的是甘特图它支持排除节假日任务时间线会自动顺延不用手算工期。 动手前 30 秒自检装之前确认三样东西就行要求说明Node.js 20运行环境Mermaid 开发环境要求 Node 20pnpm项目指定的包管理器Git拉代码用一条命令验证环境是否齐全node -v pnpm -v两个版本号都能正常打印就可以往下走了。没有 pnpm 的话先执行npm install -g pnpm。 最短路径跑起来三步命令以内没有别的# 1. 拉代码 git clone https://gitcode.com/GitHub_Trending/me/mermaid cd mermaid # 2. 装依赖首次会自动触发构建 pnpm install # 3. 起本地服务 pnpm dev然后打开http://localhost:9000左边写图、右边出图保存即刷新。 调成你顺手的样子项目跑起来后最常见的个性化就是换主题。四种内置主题直接指定即可import mermaid from mermaid; mermaid.initialize({ theme: forest // default / forest / dark / neutral 四选一 });开发服务器里的编辑器界面分三块代码、配置、预览。改配置面板里的选项预览即时生效不用来回刷新颜色、字体想再细调可以走 CSS 覆盖或官方文档里的配置项入门阶段用不着。 抄这三段就能用1. 流程把脑子里的判断逻辑画出来描述审批流、异常分支、排查步骤评审时直接贴进文档2. 序列图把接口调用顺序讲清楚排查谁先调谁的问题时一张序列图胜过三段文字3. 甘特图把排期变成一张可维护的表项目排期、里程碑跟踪改日期只改文本不用重画图⚠️ 卡住了怎么办症状 1pnpm install中途断网或装坏清一下本地存储再强制重装pnpm store prune pnpm install --force症状 29000 端口被占用服务起不来用环境变量换一个端口不用改任何配置MERMAID_DEV_PORT9100 pnpm dev症状 3图渲染出来样式不对、主题没生效九成是时序问题。先确认两件事渲染调用发生在mermaid.initialize()之后浏览器控制台没有语法报错。控制台里红色的报错信息会直接指出第几行语法有问题。接下来去哪儿每种图表的语法都写在 docs/syntax 里照着示例改就行配置项全表在 docs/config主题、边距、间距都能调想接入自己的工程或了解更多用法看 docs/intro/getting-started.md需要命令行批量导出 PNG/SVG 的话可以用社区 CLI 工具mermaid-cli一条命令出图图会过期文字不会。现在就把那张总在手绘的架构图改成 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),仅供参考
返回列表