

Obsidian Visual Skills 是一套配合 Claude Code 使用的绘图技能包,可将文字需求转成适用于 Obsidian 的图表或画布文件。它包含 Excalidraw、Mermaid 和 Canvas 三类模块,分别面向手绘表达、技术关系展示与卡片式知识整理。
这套技能包是什么,适合处理哪些内容
这套工具属于 Claude Code 的 Skills 扩展。使用者提供文字说明,Claude Code 根据技能文件中的要求组织内容并生成相应文件,再交给 Obsidian 展示。它适合已有笔记、流程说明或文章提纲,需要进一步整理成图的场景。
按照来源材料的介绍,安装方式是把各个技能文件夹放入 Claude 的配置目录。需要区分的是,技能文件提供绘图要求与格式指导,实际文件操作仍由运行环境执行,不能把复制技能文件理解为自动获得文件系统权限。
本文依据用户提供的 A姐分享 AI工具区文章材料整理,材料标注日期为2026年1月15日。由于本次未进行在线抓取,原页面和项目仓库的当前状态尚未独立核实,下文仅介绍材料中已有的信息。
Excalidraw 与 Mermaid:按表达方式选择
Excalidraw 生成器侧重手绘风格,适合项目汇报、方案说明和面向客户的沟通材料。来源称其能够生成包含 JSON 数据的 Markdown 文件,并使用 Excalifont 字体。需要把几个步骤和关系画得直观时,可以先考虑这一模块。
Mermaid 可视化器侧重结构化图表,适合技术流程、登录认证时序和状态变化等内容。图表以文本形式描述关系,便于随技术文档一起管理,也适合纳入 Git 版本记录,追踪流程发生了哪些变化。
来源提到中文渲染、语法纠错和语义配色等能力,但这些介绍不宜理解为每次输出都能正确显示。选型时应先判断内容需要手绘表达还是严格的流程关系,再检查文字、箭头和分支是否符合原意。
Canvas:把长篇内容整理成卡片关系
Obsidian Canvas 创建器面向头脑风暴和复杂知识整理。它将内容拆成卡片,并通过位置、连线和颜色表达关系,输出 Canvas 文件。相比强调先后顺序的流程图,卡片画布更适合同时呈现多个主题及其联系。
来源介绍了自动计算节点间距和使用六种预设颜色的功能。实际使用时,可以先明确哪些是主主题、哪些是补充信息,以及哪些卡片需要连接,再让工具安排布局,减少内容层级含糊带来的返工。
将文章转成画布时,建议保留核心观点和必要关系,避免把每个段落原样塞入卡片。生成后仍需检查卡片是否拥挤、连线是否清楚,以及颜色是否帮助区分内容;自动布局不能替代对信息结构的判断。
从安装技能到生成第一张图
来源列出的前提是已安装 Claude Code CLI 和 Obsidian。随后获取 Axton Obsidian Visual Skills Pack 项目,将所需模块的技能文件夹复制到 Claude 的 skills 配置目录。材料分别给出了 macOS、Linux 的复制方式和 Windows 的手动复制说明。
安装后,先选一个范围明确的小任务,例如描述 CI/CD 的主要步骤,或列出登录认证涉及的参与者和交互。输入中应包含节点、顺序、分支条件及希望使用的图表类型,让工具有足够信息组织画面。
完成生成后,在 Obsidian 中打开对应内容并核对展示结果。来源没有完整说明各类文件的展示依赖、兼容范围和排障流程,因此不能仅凭完成复制就判断整个使用过程已经配置妥当。
实验性工具的限制与输出检查
来源将该项目标为实验性原型,并建议不要直接投入五千字长文。较稳妥的路径是先让 Claude 提炼六到十个关键节点及其关系,确认提纲后再绘图。这里的节点数量是来源建议,并非工具的硬性容量上限。
中文夹杂复杂符号或 LaTeX 表达时,Mermaid 可能出现渲染问题。可以先整理文本、简化节点标签,再检查生成结果。即使画面能够正常打开,也应核对箭头方向、遗漏步骤和节点表述,避免把显示成功等同于内容正确。
来源称项目开源免费,但提供的材料没有列出具体许可证,也未完整说明配套工具的使用成本。若涉及商业用途,需要另行核对授权范围;技能包本身的介绍不足以证明整套使用流程免费或适用于所有商业场景。