📌 obsidian-markdown 是什么？
Obsidian 用 Markdown 记笔记，但它不是标准 Markdown——双链、标签、嵌入、Callout、属性，这些都是 Obsidian 独有的扩展。很多人用 Obsidian 几年，其实只会最基础的标题和列表，白白浪费了它最强大的功能。obsidian-markdown 是 Obsidian 创始人 kepano 的技能，让 AI 精通这套语法，帮你写出规范的笔记。
它的价值在于"让 AI 按 Obsidian 的规范来"，而不是按通用 Markdown 的规范来。比如同样写一个链接，Obsidian 里的 [[双链]] 和标准 Markdown 的 [文字](url) 完全是两回事，用错了知识库就串不起来。
对想认真搭个人知识库的人来说，掌握这套语法是第一步——链接、标签、结构对了，笔记才能"长"成一个可检索、可关联的网络，而不是一堆孤立的文件。
🧩 核心功能
基础语法：标题、列表、表格、代码块、引用等标准 Markdown。
双链 [[]]：写反向链接、别名、嵌入，让笔记互相连接。
标签 #tag：嵌套标签、标签组织笔记。
Callout：写提示框：注意、警告、提示、引用等。
属性 YAML：给笔记加 frontmatter 属性，方便结构化检索。
嵌入与引用：嵌入其他笔记、图片、PDF、网页。
👍 优点
规范：按 Obsidian 的语法写，不返工。
成体系：链接、标签、属性一起规划。
省心：不用自己记语法细节。
⚠️ 不足与局限
语法细节多，刚开始需要适应。
过度使用双链和标签，笔记库也会变乱。
AI 写的结构仍需你按自己的习惯调整。
🙋 适合谁用
Obsidian 用户：写规范笔记。
知识工作者：搭个人知识库。
学生研究者：记课程笔记、文献笔记。
写作者：用笔记管理素材和灵感。
🛠️ 第一次安装
前提：电脑装了 Node.js（18+），有支持 Skill 的 AI 工具（如 Claude Code）。打开终端执行：
CLI 会自动检测你装的 AI 助手，确认安装位置后即可使用，装完可以用 npx skills list 确认它在列表里。
✍️ 上手：几个真实例子
场景一：转成规范笔记
场景二：写 Callout
场景三：加属性
🎯 典型应用场景
笔记整理：把素材转成规范笔记。
知识库搭建：统一笔记结构和标签。
写作管理：用双链组织素材。
学习记录：记课程和阅读笔记。
⚖️ 和类似方案对比
和通用 Markdown 编辑器（如 Typora、VS Code）相比，obsidian-markdown 的差别在于它专门针对 Obsidian 的扩展语法，尤其双链、标签、Callout、属性这些。用通用习惯写 Obsidian 笔记，链接和结构往往对不上，后期整理很痛苦。
💡 常见问题 FAQ
问：双链和标签怎么选？
双链表达"这篇和那篇相关"，标签表达"这篇属于什么类别"，两者配合用。
问：笔记多了会乱吗？
提前定好标签和目录规则，让 AI 按规则执行，就不会乱。
问：能批量处理旧笔记吗？
可以，让 AI 批量给旧笔记补标签、建链接。
问：Callout 有几种？
常见的有 note、warning、tip、quote 等，AI 会按语义帮你选。
🤖 适合哪些 AI 工具
Claude Code、Cursor、Codex 等支持 Skill 的工具都能装。
◯ 评论 0