Obsidian 搜索语法指南 用原生搜索找回笔记和待办

笔记存得越多,找东西时越困难,虽然现在有了 AI 辅助,但是比起什么东西都给 AI 看一遍,一些基础的 Obsidian 搜索语法还是大有用武之地。 不仅搜索快/准确,而且可以避免无意义的 AI 窥探。 有些人装一了堆插件,或 AI 机器人,也就为了实现略微复杂的查询,倒不如用一下 Obsidian 自带的 搜索语法,可以事半功倍。

最近看到 Dan Holloran 的《Obsidian Search Operators: Find Anything Without a Plugin》,我觉得这个主题很值得展开。他说,我们聊 Obsidian,经常会聊双向链接、知识图谱和各种插件,而搜索框里那些现成的能力,反倒容易被忽略,我深有同感。

Obsidian 搜索语法可以把文件名、文件夹、标签、任务状态和笔记属性组合起来,也可以要求几个关键词出现在同一行或同一节里。 这些功能来自自带的 Search 核心插件,学会几个常用组合,就能处理不少日常找资料的需求。

对于长期使用本地 Markdown 的人来说,这是一项很划算的基础功。资料会继续增加,找回资料的办法也值得花一点时间熟悉。

先打开合适的搜索入口

Obsidian 里几个常用的查找入口,各自对应不同的记忆线索。

你记得什么可以使用的入口Windows / LinuxmacOS
笔记名称或别名快速切换 Quick switcherCtrl+OCmd+O
某个关键词,想跨笔记查找全库搜索 SearchCtrl+Shift+FCmd+Shift+F
内容就在当前这篇笔记里当前文件查找Ctrl+FCmd+F

下面的搜索表达式,都输入到全库搜索框里。也可以点击左侧栏的放大镜打开它。如果入口被关闭,到设置的“核心插件”里开启 Search。

比如,记得笔记大概叫“订阅服务清单”,用快速切换输入名称中的几个字就很顺手。只记得当时写过“续费”,全库搜索更适合继续追查。

Obsidian 搜索语法先记住这四种写法

搜索运算符听起来有点技术化,实际可以把它理解成给搜索条件加几个限定词。

写法示例含义
空格续费 预算同时满足两个关键词条件
英文双引号"Google Keep"查找连在一起的短语
大写 OR续费 OR 订阅满足其中一个条件即可
减号 -续费 -试用查找续费,同时排除含试用的结果

要查“讨论了 Obsidian,而且提到同步或备份”的笔记,可以写成这样。

Obsidian (同步 OR 备份)

括号把两个选项放在一组,读起来也直观。如果有多个分支,就主动加括号,把逻辑写清楚。

中文笔记同样可以使用这些语法。留意输入法,冒号、括号、引号和减号都使用英文半角字符,OR 使用大写。

还有一点很重要。普通的多个关键词可以散落在同一篇笔记的不同位置。开头提到续费,结尾提到预算,这篇笔记仍然可能符合 续费 预算。后面我们会用 line: 和 section: 把范围进一步收紧。

用 file 和 path 找文件名与文件夹

很多时候,我们还记得文件放在哪里,或者标题里有什么词。把这些线索用起来,可以少看很多结果。

file 限定文件名

file:会议

这会查找文件名里包含“会议”的文件。要同时要求文件内容提到续费,可以再加一个条件。

file:会议 content:续费

这里的 content: 明确把“续费”的匹配范围放到文件内容里。

file: 也能用于附件。比如先用 file:.pdf 查找文件名包含 .pdf 的文件,或者用 file:合同 找名称里带“合同”的文件。

Obsidian 论坛里有一个很典型的求助。用户明明能在文件列表里看到 PDF,反复搜索名称却没有结果,甚至尝试了重建缓存。后来按回复加上 file:,就找到了。这类问题很容易让人以为搜索坏了,实际上,明确告诉搜索框“我要匹配文件名”就能解决。

path 限定路径

假设你把博客相关笔记放在 Projects/XLR/ 下,想找其中提到 Obsidian 的内容。

path:"Projects/XLR/" content:Obsidian

这里填写库内路径,使用 / 分隔目录。有空格的路径用英文双引号包起来,中文目录名也可以照常填写。

再比如,想暂时排除归档目录。

Obsidian -path:"Archive/"

path: 匹配的是路径中的文本。 path:Projects 会匹配包含这段文字的路径,所以示例里写出更完整的目录片段,筛选会更明确。请把这些目录名换成你自己库里的名称。

如果日记按日期命名,file:2026-11 还能帮助找到文件名包含这个月份的笔记。这个条件依据的是命名,文件实际何时创建或修改,要另外查看时间信息。

用 tag 查标签 把资料按用途收拢

假设你已经给待阅读资料加上 #待读,给 Obsidian 相关内容加上 #Obsidian。

tag:#待读 tag:#Obsidian

这会筛出同时具有两个标签的笔记。读书笔记、网页剪藏和会议记录也可以按同样的办法组合。

直接输入 #待读 属于文本匹配,tag:#待读 则按标签查找,会跳过代码块里的示例等非标签内容。对于经常保存教程、代码片段的知识库,这个区别很实用。

嵌套标签也有自己的方向。tag:#项目 可以找到 #项目 及 #项目/XLR 这样的子标签。若标签是 #工作/项目,就要按它自己的层级来查,例如 tag:#工作/项目。

对我来说,标签很适合保存那些跨文件夹的线索。资料可以各自留在读书、剪藏和项目目录里,需要时再用几个标签收拢。

line、block、section 让关键词靠近一点

这是我觉得最值得熟悉的一组 Obsidian 搜索技巧,尤其适合日记和会议纪要。

假设一篇周记前面写了“研究笔记同步”,后面另一节写了“手机照片备份”。搜索 同步 备份,这篇笔记也可能出现,但你真正想找的,是一起讨论笔记同步和备份的那段内容。

这时可以逐步缩小匹配范围。

查询条件需要在哪个范围内同时成立
line:(同步 备份)同一行
block:(同步 备份)同一个 Markdown 块
section:(同步 备份)同一节,即两个标题之间的范围

line: 适合简短记录。例如下面两行内容,第一行满足条件。

笔记同步方案需要配套备份。
手机照片准备周末再整理。

这里的“行”按文本中的换行判断。窗口变窄之后自动折到下一行,仍可能属于同一个文本行。

block: 可以用来查同一段讨论。Markdown 中用空行分开的普通段落,属于不同的块。如果你的记录习惯是每个想法写一段,这个范围就很自然。块搜索需要解析 Markdown 结构,大库中可能花更长时间。

section: 则适合一个话题下面写了好几段的长笔记。比如某节先解释同步,再讲备份,只要都在这节的范围里,就可以一起命中。中途出现新的小标题时,要留意它也会形成节的边界。

它们控制的是匹配范围。搜索结果显示多少上下文,可以通过 Search 里的“Show more context”调整,查看完整内容时再点开原笔记。

把范围条件与目录条件组合起来,查询会更贴近日常需要。

path:"Meetings/" section:(续费 预算)

这相当于告诉 Obsidian,到会议记录里找一节同时讨论续费和预算的内容。比只丢进一个“预算”,多提供了两条很有用的线索。

用 task-todo 找散落在笔记里的待办

Obsidian 原生搜索也认识 Markdown 任务。比如,你在几篇会议记录里留下过这样的内容。

- [ ] 联系供应商确认续费价格
- [x] 联系设计师确认配图

这三个运算符可以按任务状态查找。

查询找到什么
task:联系内容包含“联系”的任务
task-todo:联系内容包含“联系”的未完成任务
task-done:联系内容包含“联系”的已完成任务

要查看项目目录中的全部未完成任务,可以使用空字符串。

path:"Projects/XLR/" task-todo:""

这样,回顾项目时就多了一个直接入口。写选题时记下的配图、开会时留下的跟进,都可以按这个范围找回来。

如果还需要排除某种任务,留意条件放在哪里。下面以平铺的单行任务为例,假设你用 #waiting 标记正在等待回复的事项。

task-todo:(联系 -#waiting)

括号里的两个条件都在未完成任务块内判断,也就是查找含“联系”、同时不含 #waiting 这段文字的任务。

如果把 -#waiting 移到括号外,它就会在整篇笔记的层面排除结果。某篇会议记录只要其他位置出现了这段文字,也可能整篇被过滤掉。排除条件放在哪一层,会直接影响你漏掉什么。

用属性搜索筛选草稿和项目资料

当笔记已经有 Properties,搜索还可以利用这些结构化信息。

假设一篇文章在顶部设置了两项属性,名称分别是 type 和 status,值分别是 article 和“草稿”。在 Markdown 源码里可以这样表示。

---
type: article
status: 草稿
---

要找这类草稿,可以输入下面的查询。

[type:article] [status:草稿]

正文里偶尔写了一句“草稿已经发给同事”,不会因此满足 status 属性条件。对于博客、项目和阅读记录,统一几个常用属性,就能留下更明确的检索线索。

还可以把“草稿”和“待修改”一起找出来。

[status:草稿 OR 待修改]

整理资料时,下面三种写法也很有用。

查询含义
[status]笔记具有 status 属性
-[status]笔记没有 status 属性
[status:null]笔记具有 status 属性,但值为空

这里的空值特指 status: 后面没有填写内容。[status:null] 会跳过写成空引号 "" 或空列表 [] 的值。模板里如果混用了这些写法,可以分别检查,或先统一为空值写法。

不用一开始就为整个库设计很多字段。对于写博客,先把文章状态记清楚,已经足够产生一个实用的草稿列表。

把常用搜索保存下来

搜索表达式开始变长之后,每次重新输入会有点麻烦。Obsidian 自带两种很方便的复用办法。

用书签保存查询

在设置中开启 Bookmarks 核心插件。搜索得到想要的结果后,点击结果数量旁的三点菜单,选择 Bookmark,再起一个容易认出的名称,例如“XLR 未完成事项”。

以后从书签打开,就可以再次执行这条查询。你可以把每周回顾需要的几条搜索放在同一组里,减少来回输入。

用 query 代码块嵌入搜索结果

也可以把下面的内容放进一篇项目首页或回顾笔记。

```query
path:"Projects/XLR/" task-todo:""
```

代码块的语言标记填写 query。在 Obsidian 中查看这篇笔记时,就能显示查询结果,随符合条件的内容变化而更新。

我觉得这一点特别适合长期维护的项目。原始记录留在各自的笔记里,项目首页负责把当前需要处理的内容展示出来,少了一份手工复制和维护的清单。

这段查询文本仍然保存在 Markdown 文件中,动态显示由 Obsidian 提供。放到普通 Markdown 阅读器里会显示为代码,Obsidian Publish 目前也不支持这种嵌入搜索结果。

搜不到时 可以先检查这些地方

PDF 正文和图片文字能直接搜吗

Search 的内容搜索覆盖笔记和 Canvas。查找 PDF、图片等附件时,可以用 file:、path: 匹配文件名和路径。扫描件可以先经 OCR 提取文字,再把文字保存到笔记中,或交给支持 OCR 的附件检索工具处理。

所以,如果你希望以后按内容找回一份附件,可以在相关笔记里补上摘要、关键词和附件链接。这样的文字说明,也能帮助未来的自己理解这份材料为何被保存。

关键词明明存在 为什么仍然没有结果

先把复杂查询缩短到一个确定存在的关键词,再逐步加回目录、标签或属性条件。检查每一步从什么时候开始没有结果,通常比整条表达式反复修改更容易定位。

同时查看设置中的 Excluded files。符合排除规则的文件会从 Search 结果中隐藏。搜索框的大小写选项、英文半角符号,以及实际目录名是否一致,也值得顺手检查。

复杂表达式可以打开 Search settings 中的 Explain search term,看看 Obsidian 如何理解这些条件。

能按最近修改排序吗

可以。在搜索结果的排序菜单中,选择修改时间从新到旧,适合找最近编辑过的材料。排序负责调整结果顺序,file:2026-11 这样的条件则依据文件名筛选,两者可以按需要分别使用。

正则表达式什么时候值得用

当你想匹配某种固定格式时,再考虑它。例如按 YYYY-MM-DD.md 命名的日记,可以用这个表达式查找文件名中的日期格式。

file:/\d{4}-\d{2}-\d{2}/

两边的 / 表示中间是一段正则表达式,Obsidian 使用 JavaScript 风格的正则语法。这个例子检查数字排列格式,月份、日期是否真实有效,还需要另外判断。

日常找笔记,前面的文件夹、标签和任务条件已经能覆盖很多场景。等出现明确的格式匹配需求,再补这一项就好。

最后

先挑一个每周都要处理的问题。比如找还没完成的文章任务,或者从会议记录里找有关预算的讨论。把查询调到结果足够准确,再保存成书签。

下一次遇到相同问题,直接打开它。需要更细时,再加一个目录、一个标签,或者一个 section:。

这样学搜索语法,比较容易感受到它的作用。笔记还在继续积累,我们也逐渐有了几条熟悉的路径,能把需要的那部分资料重新找回来。


✨欢迎订阅「效率火箭」,您的订阅将激励我们努力提供更好的内容,谢谢!

  • 我们不发每日资讯轰炸,只精选生产力工具报道。
  • 订阅后,新文章将第一时间发送到您的邮箱。
  • 您也可获得所有订阅用户专属材料。随时可退订。

Comments

发表回复