属性（Properties / Frontmatter）

如果说正文是笔记的”血肉”，属性就是它的”身份证”。一组键值对写在文件最顶部，记录这篇笔记的标签、别名、日期、状态……这些结构化数据不仅人能读，机器也能读，是后续 Dataview、Bases 等高级玩法的基础。

YAML Frontmatter 结构

属性以 YAML 格式存在文件开头，三根横线之间：

---
title: 三体读书笔记
date: 2026-07-01
status: 在读
rating: 5
tags:
  - 阅读/科幻
  - 2026/07
aliases:
  - 三体
  - 地球往事
cssclasses:
  - book-note
---

每个名字唯一，键与值之间是冒号加一个空格。列表每项前一个短横线加空格。

不必手敲 YAML。在笔记顶部按 Cmd/Ctrl+;，或在命令面板执行 “Add file property”，就会出现一行可视化的”键—值”输入框。点击键名左侧的图标可切换类型，鼠标悬停还有快捷操作。

显示方式可在 Settings → Editor → Properties in document 切换：

Obsidian 自带几个有特殊用途的属性：

旧版的 tag、alias、cssclass 在 1.4 起被弃用，1.9 后不再作为默认属性识别，迁移时记得改成复数。

属性名随便起，类型决定 Obsidian 怎么处理它：

类型一旦赋给某个属性名，全 Vault 同名属性都会沿用。文本属性里的 [[链接]] 必须加引号：link: "[[三体]]"，Obsidian 会自动补引号，但用模板插件时要留意。

侧栏的”所有属性（All Properties）“视图列出 Vault 内全部属性名、类型、出现次数。右键某个属性可重命名——这会同步全 Vault，比手动改一个个文件安全得多。

要批量改值，建议切到 Source 模式配合 VSCode 之类的工具操作；属性视图本身不支持表格级的批量编辑。属性也不支持嵌套，需要嵌套结构时切到源码模式直接写 YAML。

属性有自己的搜索运算符。在搜索框里：

[status:在读]               找出 status 为"在读"的笔记
[#科幻]                     找出含 #科幻 标签的笔记
[property:rating]           找出有 rating 属性的笔记

配合嵌套标签，tag:阅读 能匹配 #阅读/科幻、#阅读/方法论 等所有子标签。

属性真正的威力，要等查询出来才显形。Dataview 插件能像数据库一样查询属性：

```sql
TABLE rating, status
FROM #阅读
WHERE status = "在读"
SORT rating DESC
```

Bases（1.9+）则原生支持按属性做表格、卡片、看板，还能用公式属性做计算。比如给所有读书笔记打上 status 属性，就能用 Bases 一键筛出”在读”的书单，再按 rating 排序。

这部分我们留到第四部分专门讲。现在你要做的，只是养成”每篇笔记都填几个属性”的习惯——这等于给未来的自己留下了可查询的入口。

---
title: "{{title}}"
author: 
status: 待读
rating: 
started: {{date}}
finished: 
tags:
  - 阅读
aliases:
  - 
---

新建笔记套用此模板，每次读书前填几项，一年下来你就有了一个可被任意维度查询的私人书库。

属性是笔记从”散落”走向”系统”的转折点。下一篇我们聊 Callout——把重要信息装进彩色框里，让笔记自带”重点提示”。