Obsidian Dataview 数据查询指南：把笔记库变成可查询的索引

Obsidian Dataview 数据查询指南把笔记库变成可查询的索引【免费下载链接】obsidian-dataviewA data index and query language over Markdown files, for https://obsidian.md/.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-dataviewObsidian Dataview 是一款面向 Markdown 笔记的数据索引与查询语言它从 YAML 前置元数据、行内字段、标签和任务复选框中提取信息以表格、列表、任务、日历四种视图输出。这篇指南面向需要在多篇笔记间做筛选、排序和统计的用户读完你能在自己的库里跑通第一条查询并把高频查看动作变成可复用的模板。场景判断什么情况下值得引入它场景一反复翻阅的阅读记录输入是三十多篇读书笔记每篇顶部 YAML 写了作者、评分、阅读日期正文带#book标签。原来的卡点是想知道“哪些给过高分”“今年读了什么”只能逐篇人工翻看每次新增一本都要重新在脑子里汇总。引入 Dataview 后在固定笔记里写一条表格查询按标签筛选、按评分排序新笔记会自动进入结果不需要人工维护。场景二散落在多个文件里的任务状态输入是每个项目笔记里的若干- [ ]复选框。卡点是任务分散在几十个文件中无法一眼看出哪些还没完成遗漏率高。引入后一条任务型查询即可扫出库内所有未勾选的框集中展示还能按文件夹或字段过滤。判断标准如果你的库里存在几十篇以上结构一致的笔记并且需要反复从不同角度查看它们查询比手动整理更稳定如果只有零星几篇笔记、字段也不统一先花时间整理数据结构再使用。最小验证三步看到第一条查询结果在 Obsidian 社区插件市场搜索 Dataview安装并启用。建一个文件夹放两三篇样例笔记每篇顶部 YAML 写一行rating: 8正文打一个#game标签。在任意笔记的阅读模式下插入 dataview 代码块table file.name, rating FROM #game SORT rating DESC代码块下方会渲染出一张表格每篇笔记占一行、按评分排序你以后新增一篇笔记表格自动更新这是它与手动统计最大的区别。表格渲染结果每条游戏笔记一行展示元数据并按评分排序模板化能力把高频查询变成可复制的模板四种查询类型LIST、TABLE、TASK、CALENDAR对应四种常见需求前三个模板最值得收藏模板名适用时机输入输出对比表需要横向比较同类笔记的多个字段标签或文件夹 前置元数据字段可排序、可筛选的表格快捷导航需要快速跳转一组相关笔记标签或文件夹带文件链接的列表未完成任务板想集中查看库内所有未勾选项正文中的- [ ]任务统一的任务清单支持分组与排序如果只记一句口诀就用“table from sort”这个结构起步之后按需加 WHERE 过滤和 GROUP BY 分组。任务板模板同样只需几行比如排除某个文件夹、只看未完成项task FROM -recipes WHERE !completed把文件夹名替换成你自己的项目目录就得到一个随写随更的任务清单。工作流迁移让单次查询变成长期仪表盘完整案例阅读仪表盘。数据来源“books”文件夹里的读书笔记前置元数据统一使用 author、rating、read-date 三个字段名正文各带一个#book标签。操作动作新建一篇“阅读仪表盘”笔记放一条表格查询按#book取数、只显示 rating 不低于 8 的条目、按评分降序再配一条列表查询展示待读队列。输出结果仪表盘变成“活”的笔记——读完新书只需写笔记、补字段仪表盘本身一行都不用改。后续维护唯一要守住的规则是字段名保持一致新增维度比如题材时只需在前置元数据加一行、在表格查询里加一列。这样查询就从“需要时查一次”变成了“每天打开就能看到状态”周报数据、内容创作排期、项目文档清单都可以套用同一套做法字段定义一次查询写好一次结果持续消费。按类型分组展示书籍笔记数据由前置元数据自动索引生成边界与继续深入常见失败点与排查方法查询结果为空先确认数据是否属于可索引形式——正文里的普通段落不会被索引只有前置元数据字段、[key:: value]行内字段、标签和任务复选框可被查询写法见 docs/docs/annotation/add-metadata.md。代码块不渲染确认插件已启用、且处于阅读模式源码模式下代码块只是纯文本。日期函数结果异常写成纯文本的日期字段无法参与日期运算统一用2024-01-15这样的格式或交给 YAML 自动识别为日期。不适合的场景笔记量很少、字段不统一时整理字段的成本会超过查询收益Dataview 是只读的勾选任务除外不能当作编辑笔记正文的工具。安全边界dataviewjs 代码块以插件权限运行可以改动文件来源不明的脚本先读懂再使用。四种查询类型的完整语法可以参考 docs/docs/queries/query-types.md。现在挑一个最小的文件夹先把一条 table 查询跑通确认结果符合预期再决定要不要把它扩成固定仪表盘。【免费下载链接】obsidian-dataviewA data index and query language over Markdown files, for https://obsidian.md/.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-dataview创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考