Obsidian 怎样把搜索结果嵌入笔记正文

在 Obsidian 笔记中插入语言标记为 query 的围栏代码块，并把搜索条件写在块内，就能在笔记正文中显示搜索结果。它保存的是查询条件，适合做资料入口；复制搜索结果得到的链接列表则更适合保留某一时刻的整理记录。

官方帮助地址：https://obsidian.md/help/plugins/search

下面使用桌面版的核心Search功能，不安装第三方插件。示例任务是在“资料汇总”笔记中展示Notes文件夹内包含“复盘”的笔记。界面语言不同可能显示Search、Reading view、Source mode等英文名称。本文配图均为原创操作说明图，不是软件截图，也不代表已经在本机执行。

步骤1：在搜索面板确定查询条件

在左侧栏点击放大镜形的Search入口，或在Windows/Linux按Ctrl+Shift+F、macOS按Command+Shift+F。点击搜索输入框，输入 path:"Notes/" "复盘"。这里路径条件限制范围，另一个条件要求内容匹配，Notes需要换成你的实际文件夹名称。

继续前应看到搜索面板列出预期笔记；若没有结果，先确认这个仓库确实有Notes路径下包含“复盘”的笔记。不要把尚未找到结果的复杂查询直接搬进正文，再猜测是哪一层出了问题。

示例中的Notes是相对仓库的路径片段，不是电脑上的绝对路径。文件若被配置在Excluded files范围内，也可能不出现在搜索结果中。

步骤2：把query代码块写入汇总笔记

在文件列表点击已有的“资料汇总”笔记，进入编辑视图。若需要直接看见Markdown标记，点击底部状态栏的编辑模式图标，选择Source mode（源码模式）；如果状态栏没有该入口，可在设置→Editor→Show editing mode in status bar启用显示。

在正文需要展示列表的位置插入下面的Markdown。示例注释是合法的Markdown内嵌HTML注释，位于查询块外；query内部只放搜索表达式，不放解释句或注释。

```query
path:"Notes/" "复盘"
```

继续前检查能看到三行围栏结构：第一行三个英文反引号紧接query，中间为搜索条件，末行三个反引号单独闭合。不要把它写成普通的代码高亮块，也不要用单行反引号包住整段。上面的注释可以省略，不影响查询。

这一步没有把匹配笔记的正文复制进汇总，也没有创建一张数据库表；笔记里保存的仍然是可以维护的搜索条件。将汇总笔记放在Notes之外，也能避免它因包含“复盘”字样而进入本例搜索范围。

步骤3：切到阅读视图，核对正文中的结果

点击编辑器右上角的视图切换按钮，或按Ctrl+E（macOS为Cmd+E）切到Reading view（阅读视图）。如果右上角按钮没有显示，可使用状态栏模式菜单选择Reading view；按钮显示还受设置→Appearance→Show tab title bar影响。

成功状态是汇总笔记的对应位置显示搜索结果区域，而不是继续显示字面量的反引号与query文本。将正文中的文件名与步骤1的搜索面板比较，条件相同且数据未变时，应对应相同的匹配范围。示例图中的结果只是说明布局，不是实际运行证据。

今后笔记内容或路径变化会影响查询结果，这正是它适合做持续整理入口的原因。如果需要“当时有哪些资料”的固定记录，可以在搜索面板输入条件后，点击结果数量旁的三个点→Copy search results，再将复制内容整理为另一个记录；不要把动态查询当成不可变化的档案。

显示不对时，按可见状态处理

完成后，把查询条件附近的说明写清楚，例如“此处按Notes路径和复盘内容筛选”。只需读者理解入口用途，不必把每一份笔记的摘要重复录入汇总；需要固定结论时，再另写一段自己的整理文字。

需要安装Dataview吗？

不需要。本例使用Obsidian的Search查询块，不能与第三方插件的查询语言混写。

可以在一篇笔记里放多个搜索块吗？

可以按不同条件分别组织，但建议每个区域注明用途，先让各条查询在Search中表达清楚，避免多个宽泛结果区让汇总难以阅读。

为什么实时预览里有时还看到代码？

编辑视图会根据模式和光标位置展示Markdown语法。要判断本例的阅读效果，可切到明确的阅读视图，不必把编辑中的语法显示当成失败。

参考：Obsidian Search帮助、阅读与编辑模式。本文仓库场景、笔记命名与说明图为原创示例。