Obsidian 风格笔记怎么用：双链实操

Obsidian 的 Markdown 不是普通 Markdown

在 Obsidian 里记笔记的人迟早会遇到这个落差：让 AI 帮你写一段笔记，它输出的是标准 Markdown——标题、列表、加粗都没错，但双链没了、标注（Callout）没了、属性区（Frontmatter）也没了。贴进库里就是一篇"死"笔记，和周围的知识网络毫无关联。

Obsidian 风格 Markdown 技能就是补这个缺口的。它来自 kepano/obsidian-skills（MIT 许可），专门教 AI 工具正确产出 Obsidian 方言：维基链接、嵌入、标注、属性、标签、注释这些 Obsidian 在 CommonMark 和 GFM 之上的扩展语法。标准 Markdown 部分被视为已知知识，技能只聚焦"Obsidian 特有"的那一层。兼容 Claude Code、OpenClaw、Hermes Agent 等工具。

它具体管哪些语法

• 维基链接：[[笔记名]] 建立库内连接，支持 [[笔记名|显示文本]] 自定义文字、[[笔记名#标题]] 定位到小节、[[笔记名#^块ID]] 精确到块
• 嵌入：在维基链接前加感叹号，![[笔记名]] 把整篇笔记内联进来，![[image.png|300]] 嵌入指定宽度的图片，甚至 ![[document.pdf#page=3]] 嵌入 PDF 的某一页
• 标注：> [!warning] 这类 Callout 语法，支持自定义标题和折叠（- 默认折叠、+ 默认展开），内置 note、tip、warning、example 等十几种类型
• 属性区：笔记顶部的 YAML Frontmatter，管 title、tags、aliases、cssclasses 这些字段
• 标签与注释：#嵌套/标签 的层级标签体系，以及 %%不会渲染的注释%%

启用方式

它没有独立的命令行安装步骤——在兼容的 AI 工具中启用该 Skill 即可。启用后，当你让 AI 创建或编辑 Obsidian 笔记，或在对话中提到维基链接、标注、属性、嵌入时，这套语法规则就会被加载进上下文。

实操：让 AI 写一篇"活"笔记

假设你说："帮我在库里建一篇《产品复盘 2026Q2》，打上项目标签，链接到上周的会议纪要。"

启用该 Skill 后，AI 的产出会遵循技能里规定的工作流程：先在文件顶部写好属性区（title、tags、aliases），正文用标准 Markdown 组织结构，然后用 `[[会议纪要 2026-06-17]]` 而不是普通文本来挂接那篇旧笔记——Obsidian 会自动跟踪这篇笔记今后的重命名。需要突出风险时，它会用 > [!warning] 标注而不是随手加粗。写完还会提醒你在阅读视图里验证渲染效果。

技能里还有一条明确的取舍原则：库内笔记之间一律用维基链接（重命名不断链），只有指向外部网址时才用标准 Markdown 链接。这条原则能避免库里最常见的链接腐烂问题。

同样的思路也适用于标签和别名：标签尽量用 #项目/2026Q2 这种层级式写法，后续按层级筛选会顺手得多； aliases 属性则把笔记的常用叫法都登记上，以后让 AI 链接这篇笔记时，无论你说的是哪个名字都能命中。

适合谁

• 用 Obsidian 做个人知识管理、想让 AI 直接产出"即贴即用"笔记的人
• 维护团队 Obsidian 库、需要批量生成规范笔记的运营和研究人员
• 用 AI 整理读书笔记、希望双链网络不断完善的重度用户

注意事项

第一，它只管语法层，不管你的笔记体系设计——标签怎么规划、MOC 怎么组织，还是要自己定。第二，嵌入和块引用用多了会让笔记相互耦合，迁移库之前记得检查。第三，技能的参考文档（属性、嵌入、标注的完整清单）随上游仓库分发，遇到冷门语法（比如嵌套标注、自定义 CSS 类）时让它查参考文件，比让它自由发挥可靠得多。