Properties 完整指南
📌 最低版本: Obsidian 1.4+
Properties（属性）是 Obsidian 的原生元数据管理系统，提供了可视化的字段编辑界面。
概述
Properties 是 Front Matter 的可视化界面，让你可以：
- 🎯 直观地查看和编辑元数据
- 🔍 使用 Dataview 查询属性
- 📊 在文件列表中显示属性列
- 🔗 创建属性间的关联
快速开始
打开 Properties
三种方式打开 Properties 面板：
- 快捷键：
Ctrl/Cmd + ; - 命令面板：搜索「Toggle properties」
- 点击：笔记顶部的属性区域
添加第一个属性
- 点击「Add property」按钮
- 选择或创建属性名称
- 选择属性类型
- 填入值
📝 属性类型
文本 (Text)
普通文本字符串，适用于标题、描述等。
yaml
title: 我的笔记
description: 这是一篇关于 Obsidian 的笔记多行文本 (Multitext)
支持换行的长文本。
yaml
summary: |
这是一段
多行的
摘要文本数字 (Number)
数值类型，支持整数和小数。
yaml
word-count: 1500
rating: 4.5
progress: 75复选框 (Checkbox)
布尔值，true/false。
yaml
published: true
favorite: false
archived: false日期 (Date)
日期格式，支持日期选择器。
yaml
date: 2024-01-15
due: 2024-02-01日期与时间 (Date & Time)
包含时间的日期格式。
yaml
created: 2024-01-15T10:30:00
meeting: 2024-01-15 14:00列表 (List)
多个值的列表。
yaml
tags: [obsidian, pkm, note]
categories:
- 技术
- 前端链接 (Link)
指向其他笔记的链接。
yaml
parent: "[[项目总览]]"
related:
- "[[相关笔记1]]"
- "[[相关笔记2]]"别名 (Aliases)
笔记的别名列表。
yaml
aliases: [别名1, 别名2]🎨 界面使用
属性面板
┌─────────────────────────────────────┐
│ Properties [−] │
├─────────────────────────────────────┤
│ title 我的笔记 │
│ date 2024-01-15 [📅] │
│ tags [obsidian] [pkm] [+ ] │
│ status ○ published │
│ + Add property │
└─────────────────────────────────────┘内联编辑
在编辑模式下，可以直接在 YAML 区域编辑：
yaml
---
title: 我的笔记
date: 2024-01-15
tags:
- obsidian
- pkm
---拖拽排序
长按属性行左侧的拖拽手柄，可以调整属性顺序。
🔍 属性视图
在文件列表显示属性
- 右键点击文件列表列标题
- 选择「Add column」
- 选择要显示的属性
┌──────────────────┬────────────┬──────────┐
│ File │ date │ status │
├──────────────────┼────────────┼──────────┤
│ 笔记1.md │ 2024-01-15 │ draft │
│ 笔记2.md │ 2024-01-14 │ done │
│ 笔记3.md │ 2024-01-13 │ review │
└──────────────────┴────────────┴──────────┘排序和筛选
- 排序：点击列标题排序
- 筛选：支持按属性值筛选文件
📊 与 Dataview 配合
查询属性
dataview
TABLE title, date, status, tags
FROM "notes"
WHERE status = "published"
SORT date DESC计算属性
dataview
TABLE
title,
date,
(date(today) - date).days AS "天数"
FROM "daily"
WHERE date
SORT date DESC
LIMIT 7属性条件查询
dataview
LIST
FROM #project
WHERE progress >= 50 AND progress < 100
SORT priority DESC链接属性查询
dataview
TABLE
title,
parent,
choice(parent.priority = "high", "🔥", "")
FROM "projects"
WHERE parent🛠️ 高级用法
属性模板
使用 Templater 自动填充属性：
yaml
---
title: {{title}}
created: {{date:YYYY-MM-DD}}
updated: {{date:YYYY-MM-DD}}
tags: []
status: draft
---
<%*
// 自动设置项目关联
if (tp.file.folder() === "projects") {
tR += `project: ${tp.file.folder(true)}
`;
}
%>批量编辑
使用「Note composer」插件批量修改属性：
- 打开命令面板
- 搜索「Note composer: Edit frontmatter」
- 批量添加/修改/删除属性
属性搜索
在搜索框中使用属性查询：
# 搜索特定属性值
[date:2024-01-15]
# 组合搜索
[tag:#work] [status:done]
# 属性存在性搜索
[title:]📋 常用属性配置
知识管理
yaml
---
title: 知识笔记
type: note
date: 2024-01-15
tags: [knowledge, concept]
source: "[[来源笔记]]"
---任务管理
yaml
---
title: 任务名称
type: task
status: todo
priority: high
due: 2024-02-01
project: "[[项目名]]"
assigned: "[[人员]]"
---文献笔记
yaml
---
title: 书籍名称
type: book
author: 作者名
isbn: 978-xxx
year: 2024
rating: 5
tags: [reading, book]
---项目文档
yaml
---
title: 项目名称
type: project
status: active
start: 2024-01-01
end: 2024-06-30
progress: 35
team: [张三, 李四]
---🔧 设置选项
显示设置
设置 → Editor → Properties in document：
| 选项 | 说明 |
|---|---|
| Source | 始终显示 YAML 源码 |
| Live Preview | 在阅读模式显示可视化界面 |
| Automatic | 自动判断显示模式 |
推荐设置
☑️ 显示属性面板
☑️ 自动添加 date 属性
☐ 隐藏空属性📱 移动端使用
移动端属性编辑
- 点击笔记顶部的属性区域
- 在弹出的面板中编辑
- 使用日期选择器选择日期
移动端技巧
- 使用简化属性名称（更易触控）
- 减少必填属性数量
- 利用标签选择器的快速输入
⚠️ 常见问题
属性不显示
原因：YAML 格式错误
解决：检查 YAML 语法，确保：
- 冒号后有空格
- 缩进正确
- 特殊字符使用引号
属性类型错误
原因：Obsidian 无法识别类型
解决：
- 在属性设置中手动设置类型
- 使用正确的 YAML 格式
中文属性名称
建议使用英文属性名称，避免编码问题：
yaml
# 推荐
title: 标题
date: 日期
# 不推荐
标题: 标题
日期: 日期