Dataview 基本语法学习指南

食用指南

我们大体介绍 Obsidian Dataview 插件的基本语法，在不学习任何编程的前提下，看完后面罗列的内容。相信你也可以完成内容相关的内容。

Dataview 将 Obsidian Vault 变成了一个数据库，使得我们可以用 DQL (Dataview Query Language) 进行查询。

• 如果没有如何编程经验，推荐按照我们提供的顺序学习 Dataview；
• 如果你有一定数据库的基础，可以直接看 10 - Metadata 元数据 以及 41 - DQL 与 SQL 的异同；
• 如果你已经非常熟悉 Dataview 语法，但是想通过我们提供的例子找一些灵感，可以看我们的示例库；

当然如果你熟悉英文或者能够熟练使用翻译软件，可以同步阅读插件的 官方教程，这里有更加权威的教程。

结构综述

首先我们先通过一个简单的示例让你对 Dataview 的代码有部分概念，然后学习 Dataview 需要知道的一些预备知识 (Metadata)，之后拆解 Dataview 的代码结构，逐块讲解每一部分的含义，配合我们提供的例子，尽量让读者能够学会如何自己动手写一个 Dataview 代码。

• 0x 部分：用于帮助入门 Dataview基本语法：本指南，可以作为学习本基本语法教程的流程； 01 - 简单示例：你可以通过一个简单但是完善的示例来初步了解一下用 Dataview 查询时我们做了什么。

• 1x 部分：学习 Dataview 之前，你需要知道这些： 10 - Metadata 元数据：什么是 Metadata 元数据； 11 - 添加元数据至文件：如何向文件中添加元数据； 12 - 添加元数据至列表和任务：如何向一个列表或者任务添加元数据； 13 - Metadata的数据类型：这里列出了所有元数据的数据类型； 14 - 隐式字段：想知道一篇文件中有哪些已有的元数据么？看这篇就够了； 15 - Literals 字面常量：查询中的一些静态常量；

• 2x 部分：真正开始进入到代码的世界 20 - 四种查询方式：初步讲述了三种使用 Dataview 查询的方式，分别是行内查询、代码块查询和 dvjs 查询； 21 - 查询类型：详细的讲述了 Dataview 提供的四种查询结果的展示类型 List, Table, Calendar 和 Task； 22 - 查询字段：查询对象 Field，也就是我们最后想要显示的内容组成的列表； 23 - 操作符：我们对查找到的内容做的操作（筛选，排序，成组，拆分，限制数量等）； 24 - 表达式：除了查询类型和操作符以外的所有内容，都是表达式；

• 3x 部分：我们给所有函数提供了中文解释 30 - Dataview 提供的函数 Function：罗列并描述了所有 Dataview 提供的函数的作用； 31 - Dataview 中的构造函数 32 - Dataview 中的数值运算函数 33 - Dataview 中的对象操纵函数 34 - Dataview 中的字符串操纵函数 35 - Dataview 中的实用函数

• 4x 部分：一些补充的内容 40 - FAQ-常见问题：罗列了一些使用 Dataview 中可能出错的地方，如果你在自己上手编写属于自己的查询代码时报错，可以看看是否有你遇到的问题； 41 - DQL 与 SQL 的异同：列举了一些相同点和不同点； 42 - ISO 8601：详细又不特别深入的讲解一种时间格式； 43 - YAML 基础：主要讲了 YAML 的 MAP 和 LIST 内容； 44 - Dataview 设置介绍：Dataview 设置的介绍；