Obsidian Dataview 查询构建器

使用可视化控件创建 Obsidian Dataview 查询,配置字段、文件夹、标签、筛选、排序和数量限制,并复制 DQL 代码块。

可视化构建 Dataview 查询

选择视图类型,添加字段和数据来源,配置筛选条件,然后复制可用于 Obsidian 笔记的 DQL。

Obsidian Dataview 查询构建器
使用可视化控件创建 Obsidian Dataview 查询,配置字段、文件夹、标签、筛选、排序和数量限制,并复制 DQL 代码块。
查询 (Query)
类型 (Type)
列 (Columns)
file.link
Project
status
due
来源 (FROM)
文件夹 (Folder)
Projects
筛选 (WHERE)
status
不等于 (!=)
archived
排序 (SORT)
due
ASC
预览 (Preview)
```dataview
TABLE file.link AS "Project", status, due
FROM "Projects"
WHERE status != "archived"
SORT due ASC
```

这个 Obsidian Dataview 工具可以帮你构建什么

Dataview 很强大,但当你只是想快速生成一个表格、列表或筛选视图时,DQL 语法并不总是容易记住。这个可视化 DQL 构建器把常用选项转换成清晰控件,你可以选择视图类型、字段、来源、条件、排序,并复制最终代码块。

它适合项目仪表盘、阅读清单、会议记录、任务回顾、内容索引和个人知识管理等日常 Obsidian 工作流。你不需要从空白代码块开始,而是可以一步步配置查询,并观察每个选项如何改变生成的 Dataview Query Language 输出。

构建器不会读取你的 vault,也不会把笔记数据发送到服务器。它只在浏览器中生成文本,因此既适合学习 DQL 的新用户,也适合想快速草拟 TABLE 和 LIST 查询的熟练用户。

常见 Dataview 查询模式

大多数 Obsidian 仪表盘都由相似模块组成:结果类型、可选来源、筛选条件、排序规则,以及可选数量限制。

用于笔记仪表盘的 TABLE 查询

当你需要文件名、创建时间、文件夹、标签或自定义 frontmatter 字段等列时,使用 TABLE 查询。它适合项目索引、类 CRM 笔记列表、内容日历和研究仪表盘。

用于聚焦索引的 LIST 查询

当输出应保持简单时,使用 LIST 查询,例如某个文件夹下的所有笔记、带有特定标签的文件,或按更新时间排序的阅读清单。

WHERE、SORT 和 LIMIT 控件

为状态、优先级、截止日期或自定义元数据添加 WHERE 规则。排序能让最新、最旧、高优先级或最近编辑的笔记优先展示,LIMIT 可以控制大型 vault 的结果长度。

让 Dataview 结果更可靠的实践

查询语法正确并不代表一定有结果。如果 vault 中的数据与规则不匹配,Obsidian 仍可能显示空结果。

精确匹配字段名称

Dataview 字段名对拼写和结构敏感。如果笔记中使用 status、priority、due 或 project 等 frontmatter,请确保查询里使用相同名称。

从较小的数据来源开始

先选择一个确定包含匹配笔记的文件夹或标签。确认结果出现后,再逐条添加 WHERE 规则,便于定位问题来自来源、字段值还是排序表达式。

保持输出可读

好用的仪表盘不一定复杂。优先选择少量关键列、清晰别名和稳定排序;vault 变大后,用 LIMIT 控制结果长度。

可以创建的示例工作流

这些场景可以帮助你决定在构建器中配置哪些字段、文件夹、标签和筛选条件。

项目仪表盘

为 Projects 文件夹创建 TABLE 视图,展示状态、负责人、截止日期和优先级等字段。添加 WHERE 规则隐藏归档项目,并按截止日期排序。

阅读与研究索引

为 reading、source、book、article 或 research 等标签创建 LIST 或 TABLE 查询,配合作者、主题、评分或摘要状态等字段。

会议记录回顾

查询 Meetings 文件夹,展示日期、参会人、项目和跟进状态。用 WHERE 条件只显示尚未完成跟进的会议记录。

内容计划看板

为 Content 文件夹创建 TABLE 查询,展示渠道、阶段、发布日期、关键词和负责人,过滤已完成内容并按发布日期排序。

为什么使用这个 Obsidian 查询工具?

可视化查询控件

减少细小的 DQL 语法错误,用清晰的界面构建常用查询,并保持结构易读。

实时 DQL 预览

调整参数时即时查看生成的 Dataview Query Language 代码,理解每个设置如何影响最终输出。

浏览器本地生成

零数据收集。所有查询生成过程均在您的浏览器本地完成,您的笔记库数据绝不会离开您的设备。

如何使用可视化查询构建器

选择视图类型

选择 TABLE 创建列式仪表盘,或选择 LIST 创建更简单的匹配笔记索引。

筛选与配置

使用可视化控件添加 WHERE 筛选条件、定义 FROM 来源文件夹,并设置 SORT 排序规则。

一键复制使用

一键复制生成的代码块,直接粘贴到您的 Obsidian 笔记中即可生效。

常见问题解答

这个工具对我的 Obsidian 仓库安全吗?

绝对安全。本工具完全在您的浏览器前端运行,无法访问您的本地文件系统。它仅生成文本供您复制。

Obsidian 中的 Dataview 查询是什么?

Dataview 查询是一段 DQL 代码块,用来让 Obsidian 显示符合规则的笔记、任务或元数据。例如,你可以列出某个文件夹的笔记、显示特定标签文件、按 frontmatter 字段筛选,或按创建时间排序。

什么时候适合使用可视化 DQL 构建器?

手写 DQL 仍适合高级表达式或高度定制场景。可视化构建器更适合快速创建可靠查询、避免语法错误,或学习 Dataview 命令如何组合。

可以构建复杂的嵌套查询吗?

目前支持线性逻辑(AND 条件)。复杂的嵌套逻辑(OR/AND 混合)将在未来版本中推出。

为什么生成的查询在 Obsidian 中没有结果?

请检查是否已安装并启用 Dataview 插件。同时确认文件夹路径、标签和字段名称完全匹配。字段名区分大小写,Dataview 只能返回 vault 中真实存在的元数据。

可以构建 TASK 或 CALENDAR 查询吗?

当前界面专注于 TABLE 和 LIST 查询,因为它们覆盖了大量常见仪表盘和笔记索引。后续可以扩展 TASK 和 CALENDAR,但生成结果应始终保持与官方 Dataview DQL 语法一致。