Obsidian 官方 Skills

Obsidian Skills 是 Obsidian CEO 开源的官方 AI Skills 仓库，目前 27.9k stars。这套 Skill 解决了一个实际问题：普通 AI 知道 Markdown，但不懂 Obsidian 的各种专属文件格式。装上之后，AI 能从「知道 Obsidian 是什么」变成「真的会操作 Obsidian」。

官方共维护 5 个 Skill，覆盖 Canvas 画布、专属 Markdown 语法、Bases 数据库、CLI 操作和网页内容提取。

json-canvas — 生成可视化画布

让 AI 直接写 .canvas 文件。你告诉 AI「把这篇笔记的核心观点整理成一张 Canvas」，它会在 vault 里生成一个符合 JSON Canvas Spec 1.0 的文件，打开 Obsidian 即可看到节点、连线和分组。

四种节点类型：

• text — 文字卡片，支持 Markdown 语法。换行用 \n 而非 \\n，这是 AI 最容易搞错的地方
• file — 文件节点，指向 vault 里的笔记或图片（如 Attachments/diagram.png），可用 # 或 ^ 指定到特定标题或段落
• link — 外部链接节点
• group — 分组容器，将其他节点包在一起，可配标签和背景色

每种节点有 6 个必填字段：id、type、x、y、width、height。ID 为 16 位十六进制随机字符串（如 6f0ad84f44ce9c17）。画布坐标可为负值。

边的连接： fromNode 和 toNode 引用两个节点的 ID。可指定出口/入口方向（top、right、bottom、left）。toEnd 默认带箭头，fromEnd 默认为无。边可加标签和颜色。

颜色系统： 6 种预设（红 1、橙 2、黄 3、绿 4、青 5、紫 6），或用十六进制色码。

布局规范： 节点间距 50-100px，坐标对齐到 10 或 20 的倍数。

校验规则： ID 唯一、边两端节点存在、类型限四种、颜色合法、JSON 可解析。

Skill 自带的 EXAMPLES.md 包含 4 个完整示例：简单概念图、三栏看板（To Do / In Progress / Done）、研究画布（文件+链接混排，带标注连线）、流程图（分支和回环）。

obsidian-markdown — 写对 Obsidian 专属语法

覆盖 Obsidian 在 CommonMark 和 GFM 之上扩展的所有语法。

Wikilink 与 Embed：

• [[笔记名]] 链接笔记，[[笔记#标题]] 链接到特定标题，[[笔记#^块ID]] 链接到特定段落
• ![[笔记]] 嵌入完整笔记。图片可加尺寸：![[image.png|300]]（仅宽）或 ![[image.png|640x480]]（宽x高）
• PDF 指定页码：![[doc.pdf#page=3]]
• 外部图片用标准 Markdown 语法，同样支持尺寸参数

Callout：

> [!note] 语法，支持自定义标题和折叠状态（+ 展开、- 折叠）。13 种类型：note、abstract、info、todo、tip、success、question、warning、failure、danger、bug、example、quote，各有别名和颜色/图标。可嵌套，可用 CSS 自定义。

Properties（Frontmatter）：

YAML 格式。支持 Text、Number、Checkbox、Date、DateTime、List、Links 七种类型。三个默认属性：tags（可搜索+图谱显示）、aliases（链接建议别名）、cssclasses（自定义样式）。标签可在正文中用 #tag 内联写入，也在 frontmatter 中声明。

其他语法：

• %%...%% 注释（阅读模式隐藏）
• ==highlight== 高亮
• $...$ / $$...$$ LaTeX 数学公式
• Mermaid 流程图（节点可链接到笔记）
• 两种脚注：标准 [^1] 和行内 ^[内容]

参考文件含三份独立文档：CALLOUTS.md（折叠/嵌套/自定义 CSS）、EMBEDS.md（音频/视频/搜索结果嵌入）、PROPERTIES.md（属性类型和默认值）。

obsidian-bases — 配置数据库视图

Bases 是 Obsidian 的数据库功能。一个 .base 文件可按标签、属性、文件夹自动筛选笔记，以表格、看板、列表或地图展示。

筛选语法： ==、!=、>、<、&&、||，以及 and/or/not 组合。可筛选 note properties（frontmatter）、file properties（file.name、file.mtime 系统字段）和 formula properties。

公式系统： 四则运算、if() 条件判断、日期格式化、时长计算。注意：日期相减返回 Duration 类型而非数字。

四种视图类型： table、cards、list、map。每种可配置排序、分组和汇总。

嵌入方式： ![[MyBase.base]] 在笔记中嵌入视图。

参考文件 FUNCTIONS_REFERENCE.md 列出了所有可用函数的完整语法。

obsidian-cli — 直接操作 vault

让 AI 通过命令行操作 Obsidian，读写笔记、搜索内容、管理插件。

基本命令： obsidian read、create、append、search、daily、properties、tasks、tags、backlinks。

文件定位两种方式： file=笔记名（类似 wikilink 自动解析）和 path=相对路径（精确指定）。多个 vault 时用 vault=库名 指定。

插件开发调试流程：

1. plugin:reload 重新加载
2. dev:errors 检查报错
3. dev:screenshot 截图验证
4. dev:console 查看日志

其他开发命令：eval 执行 JS、dev:css 检查 CSS、dev:mobile 切换移动端模拟。

defuddle — 提取网页正文

帮 AI 从网页中提取干净 Markdown，去广告去导航省 token。

三条命令：

• defuddle parse <url> --md 转 Markdown
• defuddle parse <url> --md -o content.md 存文件
• defuddle parse <url> -p title 提取元数据

注意：URL 以 .md 结尾时用 WebFetch 而非 Defuddle。

安装方式

npx 安装（最简）：

npx skills add https://github.com/kepano/obsidian-skills
npx skills install obsidian-skills

Claude Code： 将仓库内容放到 vault 根目录的 .claude 文件夹。

Codex CLI： 将 skills/ 目录复制到 ~/.codex/skills。

OpenCode： 克隆仓库到 ~/.opencode/skills/obsidian-skills，重启后自动识别。

五个 Skill 各有侧重：json-canvas 最直观（生成可视化画布），obsidian-bases 最有生产力潜力（AI 整理笔记数据库），obsidian-cli 对插件开发者最实用（辅助调试）。共同点是让 AI 从「理解概念」升级到「直接操作」。

更多

• 花叔 huashu-skills — 端到端内容创作+设计
• 歸藏 guizang-skills — 杂志风 PPT 与 Prompt 工程
• 数字生命卡兹克 khazix-skills — 项目维护/深度分析