关于 mindmap
用于在 PlantUML 中创建思维导图的技能,适合需要呈现层级与分支的用户。它介绍标记符组织结构、分支方向、样式设置及常见渲染问题的处理方式。
主要功能
- 01使用标记符创建层级分支
- 02设置左右分支位置
- 03明确指定布局方向
- 04语法与渲染问题排查
适用场景
- 01梳理产品发布目标与风险
- 02将主题整理为嵌套分支
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ markdown-viewer/ skills --skill mindmap安装后在 Claude Code 中输入/mindmap确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
examples/basic-hierarchy.mdbilateral-layout.mdboxless-branches.mddirection-control.mdproject-planning.mdrich-text-content.mdstyled-theme.md详细介绍
思维导图生成器
快速入门: 从 @startmindmap 开始 -> 使用 * 或 +/- 标记定义根节点和分支 -> 可选设置分支侧、方向和样式 -> 用 ```plantuml 代码围栏包裹。
⚠️ 重要: 始终使用
```plantuml或```puml代码围栏。切勿使用```text——它不会渲染为图表。
关键规则
- 每个图表都以
@startmindmap开始,并以@endmindmap结束 - 每个层级通过重复标记表示:
*样式:*(根节点)、**(第 1 层)、***(第 2 层)+/-样式:+向左扩展分支,-向右扩展分支
- 在同一个局部分支中保持标记样式一致(不要随意混用缩进样式)
- 使用
left side将后续分支切换到根节点的左侧 - 需要时使用方向关键字:
top to bottom directionright to left direction
- 多行节点内容必须使用块语法:
**:Line 1\nLine 2;
- 若要快速添加颜色,使用行内节点颜色:
*[#Orange] Root**[#lightgreen] Child
- 若要重复使用主题,定义
<style>并应用<<green>>等构造型 - 节点文本支持富文本/Creole 和图标语法(参见示例)
节点语法速查表
| 模式 | 含义 | 示例 |
|---|---|---|
* Root | 使用星号语法的根节点 | * Product Strategy |
** Child | 第一层子节点 | ** Goals |
*** Grandchild | 更深层级 | *** KPI |
+ Root | 使用 +/- 语法的根节点 | + Architecture |
++ Left branch | 向一侧扩展的分支 | ++ Services |
-- Right branch | 向另一侧扩展的分支 | -- Risks |
***_ Boxless | 无边框/极简子节点 | ***_ Notes |
# Root | 替代根节点标记样式 | # Topic |
**:...; | 多行块节点 | **:Item A\nItem B; |
分支侧与方向
| 控制项 | 语法 | 使用场景 |
|---|---|---|
| 左侧分支 | left side | 从根节点向左右两侧拆分导图 |
| 从上到下 | top to bottom direction | 类似树形的纵向层级 |
| 从右到左 | right to left direction | 从右向左的阅读流程或镜像布局 |
样式选项
| 方法 | 语法 | 最适合 |
|---|---|---|
| 行内节点颜色 | **[#FFBBCC] Idea | 快速突出单个节点 |
| 可重复使用的类样式 | <style> ... .green { ... } </style> + <<green>> | 统一视觉主题 |
| 基于深度的样式 | :depth(1) { ... } | 按层级深度设置全局格式 |
| 节点/箭头全局样式 | node { ... } / arrow { ... } | 统一字体排版和连接线 |
推荐配色方案
选择符合导图用途的配色方案。快速着色可使用行内 [#hex],也可定义 <style> 类以便重复使用。
通用(柔和色调)
| 角色 | Hex | 预览 | 用途 |
|---|---|---|---|
| 根节点 | #2196F3 | 🔵 | 中心主题 |
| 分支 A | #A5D6A7 | 🟢 | 类别/分组 1 |
| 分支 B | #90CAF9 | 🔵 | 类别/分组 2 |
| 分支 C | #CE93D8 | 🟣 | 类别/分组 3 |
| 分支 D | #FFE082 | 🟡 | 类别/分组 4 |
| 叶节点 | #E0E0E0 | ⚪ | 细节节点 |
状态/RAG
| 状态 | Hex | 用途 |
|---|---|---|
| 已完成/正常 | #C8E6C9 | 已完成、运行正常 |
| 进行中 | #FFF9C4 | 正在进行、警告 |
| 受阻/风险 | #FFCDD2 | 问题、危险 |
| 尚未开始 | #E0E0E0 | 待处理、中性 |
暖色企业风
| 角色 | Hex |
|---|---|
| 根节点 | #1565C0 |
| 第 1 层 | #FFB74D |
| 第 2 层 | #4DB6AC |
| 第 3 层 | #E0E0E0 |
冷色科技风
| 角色 | Hex |
|---|---|
| 根节点 | #263238 |
| 第 1 层 | #00BCD4 |
| 第 2 层 | #80DEEA |
| 第 3 层 | #B2EBF2 |
大地色调
| 角色 | 十六进制值 |
|---|---|
| 根节点 | #5D4037 |
| 第 1 级 | #A1887F |
| 第 2 级 | #C8E6C9 |
| 第 3 级 | #FFF9C4 |
**提示:**避免使用纯高饱和度颜色(
#FF0000、#00FF00)——它们会降低可读性。背景优先使用柔和、低饱和度的色调,只在根节点使用醒目的颜色。
思维导图模式
| 模式 | 用途 | 示例 |
|---|---|---|
| 基本层级 | 主题分解和学习大纲 | 基本层级 |
| 双向布局 | 优缺点、选项与风险、双侧分析 | 双向布局 |
| 无框分支 | 轻量级次级节点和注释 | 无框分支 |
| 样式主题 | 用颜色区分分支并复用类 | 样式主题 |
| 方向控制 | 垂直或 RTL 阅读方向 | 方向控制 |
| 富文本内容 | 包含图标和格式的详细笔记 | 富文本内容 |
| 项目规划 | 工作分解和行动图 | 项目规划 |
快速示例
@startmindmap
* Product Launch
** Goals
*** Revenue
*** User Growth
left side
** Risks
*** Timeline Slip
*** Budget Overrun
right to left direction
** Channels
*** Content
*** Ads
@endmindmap
常见问题
| 问题 | 解决方案 |
|---|---|
| 图表未渲染 | 使用 ```plantuml 围栏和 @startmindmap ... @endmindmap |
| 分支深度看起来不正确 | 检查标记数量(*、**、***)以及缩进是否一致 |
| 多行文本导致解析器出错 | 使用 : ... ; 块语法,并确保末尾存在 ; |
| 颜色未应用 | 检查十六进制格式(#RRGGBB)或构造型类名称 |
| 布局方向不符合预期 | 添加明确的 top to bottom direction 或 right to left direction |
评论
支持 Markdown