Properties 属性速查表
快速查阅 Obsidian Properties（属性）的语法和用法。
版本要求
Properties 功能需要 Obsidian 1.4.0 及以上版本。
基本语法
yaml
---
property1: value1
property2: value2
property3: [value1, value2]
---数据类型
| 类型 | 语法示例 | 说明 |
|---|---|---|
| Text | title: 标题 | 单行文本 |
| List | tags: [tag1, tag2] | 列表/数组 |
| Number | priority: 1 | 数字 |
| Checkbox | published: true | 布尔值 |
| Date | created: 2024-02-15 | 日期 |
| DateTime | updated: 2024-02-15T10:30 | 日期时间 |
| Alias | aliases: [别名1, 别名2] | 笔记别名 |
| Link | project: "[[项目A]]" | 内部链接 |
内置属性
| 属性 | 类型 | 用途 |
|---|---|---|
title | text | 笔记标题 |
aliases | list | 笔记别名 |
tags | list | 标签 |
cssclass | text | CSS 类名 |
publish | boolean | 是否发布 |
permalink | text | 永久链接 |
常用属性模板
基础笔记
yaml
---
title: 笔记标题
created: {{date}}
modified: {{date}}
tags: []
---任务笔记
yaml
---
type: task
title: 任务名称
status: todo
priority: 3
due: {{date}}
project: "[[项目名]]"
tags: [task]
---阅读笔记
yaml
---
type: reading
title: 书名/文章名
author: 作者
source: https://...
rating: 4
date_read: {{date}}
tags: [reading]
---项目笔记
yaml
---
type: project
title: 项目名称
status: active
start_date: {{date}}
deadline: {{date}}
team: [成员1, 成员2]
tags: [project]
---会议笔记
yaml
---
type: meeting
title: 会议名称
date: {{date}}
time: {{time}}
location: 地点
attendees: [参会人1, 参会人2]
project: "[[关联项目]]"
tags: [meeting]
---Dataview 查询
基本查询
dataview
TABLE property1, property2
FROM "folder"
WHERE property = "value"常用查询示例
按属性筛选
dataview
TABLE status, due
FROM "Projects"
WHERE status = "active"
SORT due ASC按日期范围筛选
dataview
TABLE date, title
FROM "Notes"
WHERE date >= date(2024-01-01) AND date <= date(2024-12-31)计算统计
dataview
TABLE length(rows) as "数量"
FROM "Notes"
GROUP BY typeTemplater 集成
自动日期
javascript
---
created: <% tp.date.now("YYYY-MM-DD") %>
modified: <% tp.file.last_modified_date("YYYY-MM-DD") %>
---动态属性
javascript
---
title: <% tp.file.title %>
created: <% tp.file.creation_date("YYYY-MM-DD") %>
folder: <% tp.file.folder() %>
---用户输入
javascript
---
title: <% tp.system.prompt("笔记标题") %>
tags: [<% tp.system.prompt("标签（逗号分隔）") %>]
status: <% tp.system.suggester(["draft", "published"], ["draft", "published"]) %>
---高级语法
多行文本
yaml
---
summary: |
这是第一行。
这是第二行。
可以包含多行内容。
---嵌套结构
yaml
---
meta:
author: 张三
version: 1.0
updated: 2024-02-15
---访问嵌套属性：meta.author
带引号的值
yaml
---
title: "包含: 冒号的内容"
description: '包含 "引号" 的内容'
---特殊字符
yaml
---
regex: "\\d+\\.\\d+" # 正则表达式需要转义
path: "C:\\Users\\Name" # Windows 路径需要转义
---属性命名规范
推荐
yaml
# 使用下划线分隔
created_date: 2024-02-15
modified_date: 2024-02-20
# 使用小写
title: 标题
status: active
# 保持简洁
due: 2024-02-20避免
yaml
# 避免空格
Created Date: 2024-02-15 # ❌
# 避免特殊字符
@type: note # ❌
# 避免驼峰式（可选）
createdDate: 2024-02-15 # ⚠️ 不推荐标准属性词汇表
状态属性
| 值 | 用途 |
|---|---|
draft | 草稿 |
review | 审核中 |
active | 活跃/进行中 |
completed | 已完成 |
archived | 已归档 |
on-hold | 暂停 |
类型属性
| 值 | 用途 |
|---|---|
note | 普通笔记 |
project | 项目 |
task | 任务 |
meeting | 会议 |
reading | 阅读笔记 |
reference | 参考资料 |
优先级
| 值 | 含义 |
|---|---|
1 / high | 高优先级 |
2 / medium | 中优先级 |
3 / low | 低优先级 |
快捷操作
| 操作 | 方法 |
|---|---|
| 添加属性 | 笔记顶部输入 --- |
| 查看属性 | 点击属性区域 / 右上角图标 |
| 编辑属性 | 直接编辑 YAML |
| 删除属性 | 删除对应行 |
Tasks 插件集成
yaml
---
due: 2024-02-20
completed: false
priority: high
tags: [task, urgent]
---在 Tasks 查询中使用：
tasks
not done
due before tomorrow
priority above medium常见问题
| 问题 | 解决方案 |
|---|---|
| 属性不显示 | 检查 YAML 语法 |
| 中文乱码 | 确保文件 UTF-8 编码 |
| 属性类型错误 | 在属性面板手动设置类型 |
| 批量修改 | 使用 Templater 或 Metadata Menu |