4.2 Frontmatter 屬性

📋 什麼是 Frontmatter？

Frontmatter 是放在筆記最開頭的元數據區塊，使用 YAML 格式， 讓你為筆記添加結構化資料。這些資料不會在閱讀模式中顯示，但可以用來：

• 為筆記添加屬性（作者、日期、狀態等）
• 與外掛整合（Dataview、Templater 等）
• 建立更強大的搜尋和篩選
• 自動化工作流程

✍️ 基本語法

Frontmatter 使用三個破折號 --- 包裹，必須放在筆記最開頭：

---
title: 我的筆記標題
author: 張三
created: 2024-04-04
tags: [學習, 筆記]
---

# 筆記內容從這裡開始
...

🔤 資料類型

文字（String）

---
title: 我的筆記
author: 張三
status: 進行中
---

數字（Number）

---
priority: 1
rating: 4.5
page_count: 320
---

布林值（Boolean）

---
published: true
draft: false
---

日期（Date）

---
created: 2024-04-04
due_date: 2024-04-30
modified: 2024-04-04 14:30
---

清單（List）

---
tags: [學習, JavaScript, 前端]
# 或
tags:
  - 學習
  - JavaScript
  - 前端
---

物件（Object）

---
book:
  title: 原子習慣
  author: James Clear
  year: 2018
---

🎯 常用屬性範例

讀書筆記

---
type: 讀書筆記
title: 原子習慣
author: James Clear
rating: 5
status: 已讀完
started: 2024-03-01
finished: 2024-03-15
tags: [書籍, 習慣養成, 個人成長]
---

專案筆記

---
type: 專案
project: 網站改版
status: 進行中
priority: 高
owner: 張三
deadline: 2024-05-01
tags: [專案, 網頁開發]
related:
  - [[需求分析]]
  - [[技術評估]]
---

會議記錄

---
type: 會議記錄
date: 2024-04-04
attendees: [張三, 李四, 王五]
duration: 60
location: 會議室A
tags: [會議, 團隊, 每週]
---

學習筆記

---
type: 學習筆記
subject: JavaScript
topic: 閉包
difficulty: 中
mastery: 80%
last_reviewed: 2024-04-04
tags: [程式設計, JavaScript]
---

🔍 使用 Dataview 查詢

安裝 Dataview 外掛後，可以用 Frontmatter 建立動態表格和清單。

列出所有進行中的專案

```dataview
TABLE status, priority, deadline
FROM #專案
WHERE status = "進行中"
SORT priority DESC
```

顯示本月讀完的書

```dataview
LIST
FROM #書籍
WHERE finished >= date(2024-04-01)
  AND finished <= date(2024-04-30)
```

建立待辦清單

```dataview
TASK
WHERE !completed
GROUP BY file.folder
```

⚙️ 自定義屬性

你可以建立任何自定義屬性，根據需求設計：

健身記錄

---
workout: 重訓
exercises: [深蹲, 臥推, 硬舉]
duration: 90
calories: 450
feeling: 很好
---

料理食譜

---
recipe: 番茄炒蛋
cuisine: 中式
difficulty: 簡單
time: 15
servings: 2
ingredients:
  - 雞蛋 3顆
  - 番茄 2顆
  - 蔥 1根
---

電影筆記

---
movie: 星際效應
director: Christopher Nolan
year: 2014
genre: [科幻, 劇情]
rating: 5
watched: 2024-04-01
rewatchable: true
---

🛠️ 實用技巧

1. 使用模板自動添加

建立筆記模板，預設好 Frontmatter 結構：

---
type: 會議記錄
date: {{date}}
attendees: []
tags: [會議]
---

# 會議記錄 - {{date}}

## 議程
...

2. 在檔案總管中顯示屬性

設定 → 檔案與連結 → 在檔案總管中顯示內聯元數據

3. 批量編輯屬性

使用外掛（如 MetaEdit）可以快速編輯多個筆記的 Frontmatter。

⚠️ 常見問題

Q: Frontmatter 沒有正確解析？

檢查：

• 是否在檔案最開頭（第一行）
• 上下是否都有 ---
• YAML 語法是否正確（縮排、冒號後有空格）

Q: 中文標籤在 Frontmatter 中顯示異常？

使用清單格式並加引號：

tags: ["學習", "程式設計"]

Q: 如何在內容中引用 Frontmatter 屬性？

使用 Templater 外掛：

這本書的作者是 <% tp.frontmatter.author %>

💡 下一步

現在你已經掌握 Frontmatter！在下一課，我們將學習別名與重新命名—— 讓筆記可以有多個名稱，並安全地重新命名而不破壞連結。