obsidian-vault

效率工具社区 @mattpocock

信任分: 88/100
兼容 Agent: 1

速查档案只列事实：领域、Agent、信任分、作者、原文章节。装与不装请看下方作者解读。

领域: 效率工具
兼容 Agent: Claude Code
信任分: 88 / 100 · 社区维护
作者 / 版本 / 许可: @mattpocock · 未声明 license
安装命令数: 1 条

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

解读由编辑根据原文凝练而成，命令、链接、术语均与作者原文一致；想看完整论述请切到右侧

设计思路

obsidian-vault 是 mattpocock 把「让 LLM 在我的 Obsidian 笔记库里查、写、连」做成可执行的 SOP——核心约定一句话：根目录扁平、不用文件夹，靠 Index 笔记和 [[wikilinks]] 做组织。这套约定决定了所有 grep / find 的搜索路径都简单直接。

Vault 位置

/mnt/d/Obsidian Vault/AI Research/，根目录基本扁平。

命名约定

Index 笔记：聚合相关主题的目录页，例如 Ralph Wiggum Index.md / Skills Index.md / RAG Index.md
Title Case 命名所有笔记
不用文件夹——靠链接 + Index 笔记组织

链接

用 Obsidian 原生 [[wikilinks]] 语法
笔记末尾列出依赖 / 相关笔记
Index 笔记本质就是 [[wikilinks]] 列表

工作流

搜笔记（按文件名）

find "/mnt/d/Obsidian Vault/AI Research/" -name "*.md" | grep -i "keyword"

搜笔记（按内容）

grep -rl "keyword" "/mnt/d/Obsidian Vault/AI Research/" --include="*.md"

也可以直接用 Grep / Glob 工具指向 vault 路径。

新建笔记

文件名用 Title Case
内容按「一个学习单元」写
末尾加 [[wikilinks]] 指向相关笔记
如果是有编号的系列，沿用层级编号方案

找反向链接

grep -rl "\[\[Note Title\]\]" "/mnt/d/Obsidian Vault/AI Research/"

列所有 Index 笔记

find "/mnt/d/Obsidian Vault/AI Research/" -name "*Index*"

适合谁

用 Obsidian 长期记知识、希望让 LLM 在仓库里读写的人
习惯扁平 + 双向链接（不靠文件夹）的笔记体系
给个人 vault 配 AI 助手的研究者 / 学生

何时不该用

vault 不在指定路径或结构差异大——配置先对齐
公司 / 团队的 Notion / Confluence——这是 Obsidian-only 约定

配套

learn（项目内的 learning 库，是 vault 的轻量替代）、grill-with-docs（CONTEXT.md / ADR 是项目内的 vault 思路）。

Obsidian Vault

Vault location

/mnt/d/Obsidian Vault/AI Research/

Mostly flat at root level.

Naming conventions

Index notes: aggregate related topics (e.g., Ralph Wiggum Index.md, Skills Index.md, RAG Index.md)
Title case for all note names
No folders for organization - use links and index notes instead

Linking

Use Obsidian [[wikilinks]] syntax: [[Note Title]]
Notes link to dependencies/related notes at the bottom
Index notes are just lists of [[wikilinks]]

Workflows

Search for notes

# Search by filename
find "/mnt/d/Obsidian Vault/AI Research/" -name "*.md" | grep -i "keyword"

# Search by content
grep -rl "keyword" "/mnt/d/Obsidian Vault/AI Research/" --include="*.md"

Or use Grep/Glob tools directly on the vault path.

Create a new note

Use Title Case for filename
Write content as a unit of learning (per vault rules)
Add [[wikilinks]] to related notes at the bottom
If part of a numbered sequence, use the hierarchical numbering scheme

Search for [[Note Title]] across the vault to find backlinks:

grep -rl "\\[\\[Note Title\\]\\]" "/mnt/d/Obsidian Vault/AI Research/"

Find index notes

find "/mnt/d/Obsidian Vault/AI Research/" -name "*Index*"