用途:该技能用于指导创建美观、专业的 Mermaid 图表,使其能在 GitHub 上正确渲染,并在浅色与深色模式下都保持可读性。适用于 PR 架构图、系统流程文档、数据管道可视化、流程图及 GitHub Markdown 中的其他图表。
核心原则:使用深色填充配浅色描边,保证两种模式下均可读;子图填充设为 none 以适应任意背景;使用圆角形状,如 ([text]) 表示 stadium 形、((text)) 表示圆形;不使用 Font Awesome 图标,因为 GitHub 不支持 fa:fa-*,会渲染为文本;子图标签需加引号,使用 subgraph Name["Label Text"] 语法;classDef 样式定义在顶部,便于维护。
样式写法:classDef myStyle fill:#DARK_COLOUR,stroke:#LIGHT_COLOUR,stroke-width:2px,color:#fff。填充用较深的颜色作为节点背景,描边用同色系较浅颜色作为边框,文字颜色始终为 #fff。
节点形状:A(["Stadium shape"]) 用于多数节点,B((Circle)) 用于用户或角色,C{{"Decision"}} 用于判断,D[(Database)] 用于数据库或存储。
子图样式:style MySubgraph fill:none,stroke:#8b5cf6,stroke-width:2px,stroke-dasharray:5 5,color:#8b5cf6。fill:none 使背景透明,stroke-dasharray 可选虚线边框,color 设置子图标签颜色。
链接样式:A --> B 实线箭头,A -.-> B 虚线箭头,A -.->|Label| B 带标签虚线箭头,A ==> B 粗箭头。
常见错误:使用 Font Awesome 图标;浅色填充配深色文字导致深色模式不可见;子图使用彩色填充;子图标签含空格却未加引号。GitHub 不支持 HTML,节点标签中不能使用 <br> 等标签。建议在提交前使用 mermaid.live 本地预览。常用颜色配对示例包括灰 #374151/#d1d5db、紫 #5b21b6/#ddd6fe、蓝 #1e40af/#bfdbfe、橙 #c2410c/#fed7aa、绿 #047857/#a7f3d0 等,可按需选择,原则是深填充加浅描边。