Obsidian 用户必装：让 AI 真的会写你的笔记（kepano 官方 Skill）

你有没有过这种崩溃时刻：让 AI 帮你写 Obsidian 笔记，结果它给你输出一堆 [[双中括号]]、!、> [!note]……你自己读着都别扭，更别说放到 vault 里渲染了——要么乱成一锅粥，要么 callout 整个不显示。

我最近翻到一个神级 Skill，专门治这个：kepano/obsidian-skills 里的 obsidian-markdown。

这是谁出的？

kepano——Obsidian 创始人本人的网名。这个仓库（43.4k stars）是 Obsidian 官方授权给 AI agent 用的「Obsidian 私有语法字典」。obsidian-markdown 是里面最常用的一个，专注一件事：让你的 agent 真的会写 Obsidian Flavored Markdown，不是普通 md。

它解决什么问题？

Obsidian 在 CommonMark 之上加了一堆「私货」语法，普通 AI 全不会：

• Wikilinks：[[笔记名]]、[[笔记名#标题]]、[[笔记名#^block-id]] —— 重命名自动追踪
• Embeds：![[image.png|600]]、![[document.pdf#page=3]] —— 内嵌图片/PDF/笔记片段
• Callouts：> [!tip] 提示 / > [!warning]- 默认折叠 —— 醒目提示框，13 种类型
• Frontmatter Properties：tags: [project, active]、status: in-progress —— 元数据
• 高亮：==这段文字高亮==、注释：%%只在编辑模式可见%%
• LaTeX + Mermaid + 脚注 一应俱全

没这个 Skill，AI 写的笔记进 vault 一翻车：callout 变成普通引用、wikilink 显示裸 [[]]、frontmatter 漏字段……你得手动改一遍。

使用方式（30 秒搞定）

# Claude Code 用户
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

# 任何 agent 通用（npx）
npx skills add https://github.com/kepano/obsidian-skills

或者直接把 skills/obsidian-markdown 目录扔到你的 ~/.claude/skills/ 下。重启 agent，它就「学会」Obsidian 私有语法了。

适用场景

• 写 daily note、weekly review、读书笔记
• 让 AI 帮你整理 vault、做 link audit
• 自动生成项目文档（带 callout 警告 + 任务清单 + 关联笔记）
• 批量改写笔记风格（比如把所有 > 引用统一改成 callout）

顺便说一句

这个仓库里还有 4 个同系列 skill：obsidian-cli（命令行操作 vault）、obsidian-bases（写 .base 数据库视图）、json-canvas（画思维导图）、defuddle（网页抓取转干净 md）——全是 Obsidian 重度用户的刚需。建议一起装。

Obsidian 用户闭眼入，AI 写笔记的体验直接升级一个档次。

GitHub: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown

GitHub: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown