Obsidian 可视化 Skills 套装

你是否曾希望：只需一句话，就能在 Obsidian 中自动生成一张流程图、思维导图或交互式 Canvas？现在，通过 Axton Liu 开发的“可视化 Skills 套装”，这一设想已成为现实。

这套工具基于 Claude Code 的 Skills 机制，无需复杂配置，仅靠几个 Markdown 文件，就能让 Claude 理解如何为你生成 Excalidraw、Mermaid 和 Obsidian Canvas 三种主流可视化格式——全部原生兼容 Obsidian。

⚠️ 状态：实验性（Experimental）
当前为公开原型，适用于常见场景，但尚未覆盖所有边界情况。输出质量受模型版本和输入结构影响，建议配合可复现反馈使用。

什么是 Skills？

Skills 是 Claude Code 的轻量级能力扩展机制。与需要部署 MCP 服务器的方案不同，Skills 本质是结构化的提示词模板（以 SKILL.md 形式存在），Claude 会在对话中按需加载，实现专业化输出。

这意味着：零后台、零依赖、纯本地——只要 Claude Code 能运行，Skills 就能生效。

三件套功能详解

1️⃣ Excalidraw 图表生成器

用途：生成手绘风格白板图，适合灵感记录、架构草图、关系梳理。
输出：.md 文件，内嵌 Excalidraw JSON，Obsidian 安装 Excalidraw 插件 后可直接编辑。

✅ 支持类型：流程图、思维导图、层级图、关系图、对比图、时间线、矩阵图、自由布局
✅ 核心特性：

• 自动保存为 Obsidian 可识别格式
• 使用 Excalifont 手写字体（fontFamily: 5）
• 完整中文支持，正确处理标点与长文本
• 统一配色与节点样式

触发示例：

“用 Excalidraw 画一个用户登录流程图”
“创建一个关于 AI 代理架构的思维导图”

2️⃣ Mermaid 可视化器

用途：生成专业、可嵌入文档的代码化图表，适合技术写作、系统设计。
输出：标准 Mermaid 代码块，兼容 Obsidian、GitHub、Typora 等平台。

✅ 支持类型：流程图、循环图、对比图、思维导图、时序图、状态图
✅ 核心特性：

• 内置语法防护：自动规避列表冲突、非法字符、子图命名错误
• 可选布局模式（垂直/水平，简洁/详细）
• 语义化配色（如错误用红色、成功用绿色）
• 无需手动调试语法

触发示例：

“把这个 API 调用流程转成 Mermaid 时序图”
“用 Mermaid 画一个 CI/CD 工作流”

3️⃣ Obsidian Canvas 创建器

用途：生成 .canvas 文件，打造无限画布式知识网络。
输出：符合 JSON Canvas 规范的文件，双击即可在 Obsidian 中打开。

✅ 布局模式：

• 思维导图：中心辐射式，适合主题展开
• 自由布局：任意拖拽，适合复杂关系建模

✅ 核心特性：

• 智能节点尺寸（根据文本长度自动调整）
• 自动连线 + 关系标签
• 6 种预设颜色 + 自定义 HEX
• 防重叠算法 + 节点分组支持

触发示例：

“把这篇读书笔记转成 Canvas 思维导图”
“创建一个项目里程碑的自由布局 Canvas”

安装步骤（仅需 3 行命令）

前提：

• 已安装 Claude Code CLI
• Obsidian 已启用 Excalidraw 插件（如需使用 Excalidraw 功能）

# 1. 克隆仓库
git clone https://github.com/axtonliu/axton-obsidian-visual-skills.git

# 2. 复制 Skills 到 Claude Code 目录
cp -r axton-obsidian-visual-skills/excalidraw-diagram ~/.claude/skills/
cp -r axton-obsidian-visual-skills/mermaid-visualizer ~/.claude/skills/
cp -r axton-obsidian-visual-skills/obsidian-canvas-creator ~/.claude/skills/

也可按需只安装其中一个 Skill。

安装后无需重启，下次调用相关指令时，Claude Code 会自动激活对应能力。

使用建议

• 明确指定格式：在请求中包含 Excalidraw、Mermaid 或 Canvas 等关键词，可提高命中率；
• 提供结构化输入：如“步骤1… 步骤2…”比模糊描述更易生成准确流程图；
• 中文完全支持：可直接用“画一个思维导图”等中文指令。