Front Matter 速查表

📋 YAML Front Matter 是笔记开头的元数据区块，用于存储结构化信息，支持 Dataview 查询和自动化处理。

快速参考

基本语法

---
title: 笔记标题
date: 2024-01-15
tags: [obsidian, pkm]
---

笔记正文内容...

核心要点

要点	说明
位置	必须在文件最开头
标记	用 --- 包围
格式	YAML 语法
编码	UTF-8

---

📝 数据类型

字符串

title: 简单字符串
subtitle: "带引号的字符串"
description: >
  多行字符串
  会自动换行
summary: |
  保留格式的
  多行字符串

数字

age: 25
rating: 4.8

布尔值

published: true
draft: false
favorite: true

日期

date: 2024-01-15
datetime: 2024-01-15T10:30:00
created: 2024-01-15 10:30

列表

tags: [work, project, urgent]
categories:
  - 技术
  - 前端
  - React

键值对（对象）

author:
  name: 张三
  email: zhangsan@example.com
  social:
    twitter: "@zhangsan"
    github: "zhangsan"

---

🏷️ 常用字段

基础信息

字段	类型	说明	示例
title	string	笔记标题	title: 我的笔记
aliases	list	别名列表	aliases: [别名1, 别名2]
date	date	创建日期	date: 2024-01-15
updated	date	更新日期	updated: 2024-01-20
tags	list	标签	tags: [work, idea]

内容分类

字段	类型	说明	示例
category	string	分类	category: 技术
type	string	笔记类型	type: note
status	string	状态	status: draft
priority	string	优先级	priority: high

项目管理

字段	类型	说明	示例
project	string	所属项目	project: Obsidian
due	date	截止日期	due: 2024-02-01
completed	boolean	完成状态	completed: false
progress	number	进度	progress: 75

学习笔记

字段	类型	说明	示例
source	string	来源	source: 书籍名称
author	string	作者	author: 作者名
url	string	链接	url: https://...
isbn	string	ISBN	isbn: 978-xxx

---

🔍 Dataview 字段

字段类型映射

Dataview 类型	YAML 写法
Text	field: "文本" 或 field: 文本
Number	field: 123 或 field: 3.14
Boolean	field: true 或 field: false
Date	field: 2024-01-15
List	field: [a, b, c]
Link	field: "[[其他笔记]]"

内联字段

除了 YAML front matter，Dataview 还支持内联字段：

---
# YAML front matter
priority: high
---

# 笔记正文

这是一个内联字段：
priority:: high
status:: in-progress
due:: 2024-02-01

也可以写在行内：这是 [priority:: high] 优先级的任务。

Dataview 查询示例

TABLE title, date, tags
FROM "notes"
WHERE status = "published"
SORT date DESC

TABLE project, due, priority
FROM #task
WHERE !completed
SORT priority DESC, due ASC

---

📋 模板示例

基础笔记模板

---
title: {{title}}
date: {{date}}
tags: []
aliases: []
---

# {{title}}

## 概述


## 内容


## 相关链接

项目笔记模板

---
title: {{title}}
type: project
status: planning
created: {{date}}
updated: {{date}}
tags: [project]
---

# {{title}}

## 项目概述


## 目标

- [ ] 目标1
- [ ] 目标2

## 进度

| 阶段 | 状态 | 备注 |
|------|------|------|
| 规划 | ✅ | |
| 执行 | 🔄 | |
| 完成 | ⏳ | |

## 相关资源

读书笔记模板

---
title: {{title}}
type: book-note
author: 
source: 
isbn: 
date-started: {{date}}
date-finished: 
rating: 
tags: [book, reading]
---

# {{title}}

## 书籍信息

- 作者：作者名
- ISBN：xxx
- 阅读日期：开始 - 结束
- 评分：⭐⭐⭐⭐⭐

## 核心观点

1. 
2. 
3. 

## 精彩摘录

> 

## 我的思考

会议笔记模板

---
title: "{{date}} 会议记录"
type: meeting
date: {{date}}
attendees: []
project: 
tags: [meeting]
---

# 会议记录

## 基本信息

- **日期**：{{date}}
- **参会人员**：张三、李四
- **主题**：

## 议程

1. 
2. 

## 讨论内容

### 议题一


### 议题二


## 待办事项

- [ ] 任务1 @张三
- [ ] 任务2 @李四

## 下次会议

- 时间：
- 议题：

日记模板

---
title: "{{date}} 日记"
type: daily
date: {{date}}
mood: 
weather: 
tags: [daily]
---

# {{date}} 日记

## 今日心情

- 心情：
- 天气：

## 今日目标

- [ ] 
- [ ] 

## 今日记录


## 明日计划

- [ ]

---

🛠️ 自动化技巧

Templater 自动填充

---
title: {{title}}
created: {{date:YYYY-MM-DD}}
updated: {{date:YYYY-MM-DD}}
tags: []
---

# 使用 Templater 自动插入

创建时间：{{date:YYYY-MM-DD HH:mm}}
文件名：{{title}}

Linter 插件规则

使用 Obsidian Linter 自动格式化 front matter：

1. 自动添加缺失的 date 字段
2. 自动更新 updated 字段
3. 自动排序字段顺序
4. 自动格式化标签

Dataview 自动计算

---
start_date: 2024-01-01
end_date: 2024-01-31
---

进度：`=(this.end_date - this.start_date).days` 天

---

📊 与其他工具集成

Hugo 静态博客

---
title: "文章标题"
date: 2024-01-15
draft: false
description: "文章摘要"
categories: ["技术"]
tags: ["obsidian", "pkm"]
keywords: ["知识管理", "笔记"]
toc: true
---

Jekyll 博客

---
layout: post
title: "文章标题"
date: 2024-01-15 10:30:00 +0800
categories: jekyll update
author: 张三
---

Notion 导入

---
title: 页面标题
Created time: 2024-01-15
Last edited time: 2024-01-20
Status: In progress
---

---

⚠️ 常见问题

YAML 语法错误

# ❌ 错误：冒号后没有空格
title:错误格式

# ✅ 正确：冒号后有空格
title: 正确格式

特殊字符处理

# 包含冒号需要用引号
title: "标题: 包含冒号"

# 包含引号需要转义
description: "他说\"你好\""

# 多行文本
content: |
  第一行
  第二行
  第三行

中文编码

确保文件保存为 UTF-8 编码，否则中文字符可能显示异常。

---

🔗 相关阅读

• Dataview 速查表
• Templater 速查表
• Markdown 速查表