mcpField
M
mindmap

mindmap

github.com/markdown-viewer生产力3.4k3.2k 次安装3 周前更新
代码仓库

关于 mindmap

用于在 PlantUML 中创建思维导图的技能,适合需要呈现层级与分支的用户。它介绍标记符组织结构、分支方向、样式设置及常见渲染问题的处理方式。

主要功能

  1. 01使用标记符创建层级分支
  2. 02设置左右分支位置
  3. 03明确指定布局方向
  4. 04语法与渲染问题排查

适用场景

  1. 01梳理产品发布目标与风险
  2. 02将主题整理为嵌套分支

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/markdown-viewer/skills --skill mindmap

安装后在 Claude Code 中输入/mindmap确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

examples/
basic-hierarchy.md
bilateral-layout.md
boxless-branches.md
direction-control.md
project-planning.md
rich-text-content.md
styled-theme.md

详细介绍

思维导图生成器

快速入门: 从 @startmindmap 开始 -> 使用 * 或 +/- 标记定义根节点和分支 -> 可选设置分支侧、方向和样式 -> 用 ```plantuml 代码围栏包裹。

⚠️ 重要: 始终使用 ```plantuml 或 ```puml 代码围栏。切勿使用 ```text——它不会渲染为图表。

关键规则

  • 每个图表都以 @startmindmap 开始,并以 @endmindmap 结束
  • 每个层级通过重复标记表示:
    • * 样式:*(根节点)、**(第 1 层)、***(第 2 层)
    • +/- 样式:+ 向左扩展分支,- 向右扩展分支
  • 在同一个局部分支中保持标记样式一致(不要随意混用缩进样式)
  • 使用 left side 将后续分支切换到根节点的左侧
  • 需要时使用方向关键字:
    • top to bottom direction
    • right 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