結構化中繼資料 — 每次匯出都是知識資產
YAML frontmatter 將您的 Markdown 匯出從簡單的文字檔案轉化為結構化、可查詢的知識資產。每個檔案都攜帶豐富的中繼資料，使其在 Obsidian、Notion 和其他 PKM 工具中可搜尋。
什麼是 YAML Frontmatter？
YAML frontmatter 是 Markdown 檔案頂部的結構化中繼資料區塊，包含在 --- 標記之間：
yaml
---
title: "Building a REST API with FastAPI"
tags: [python, fastapi, rest-api, backend]
summary: "Step-by-step guide to creating a RESTful API using FastAPI, including authentication and database integration."
model: claude-3.5-sonnet
platform: claude
date: 2024-01-15
word_count: 3420
---此中繼資料在渲染的 Markdown 中不可見，但可被 Obsidian Dataview 等工具讀取，讓您可以對知識庫進行強大的查詢。
完整的 YAML frontmatter 範例，包含所有欄位
可用欄位
所有欄位可在 設定 → 一般 → Frontmatter 中個別切換：
基本資訊：
| 欄位 | 說明 | 預設 |
|---|---|---|
| 標題 | 自動產生的對話標題 | 開啟 |
| 對話 ID | 對話的唯一識別碼 | 開啟 |
| 平台 | AI 平台名稱（chatgpt、claude 等） | 開啟 |
| 模型名稱 | 使用的 AI 模型（gpt-4、claude-sonnet-4 等） | 開啟 |
| 來源 URL | 返回原始對話的連結 | 開啟 |
時間資訊：
| 欄位 | 說明 | 預設 |
|---|---|---|
| 建立時間 | 對話開始的時間 | 開啟 |
| 更新時間 | 對話最後更新的時間 | 開啟 |
| 匯出時間 | 執行匯出的時間 | 開啟 |
統計資料：
| 欄位 | 說明 | 預設 |
|---|---|---|
| 訊息數量 | 對話中的訊息數 | 開啟 |
| 字數 | 總字數 | 開啟 |
| 內容類型 | 內容類型（程式碼、圖片、表格、引用） | 開啟 |
AI 增強：
| 欄位 | 說明 | 預設 |
|---|---|---|
| AI 標籤 | AI 產生的主題標籤 | 關閉 |
| AI 摘要 | AI 產生的對話摘要 | 關閉 |
格式：
| 欄位 | 說明 | 預設 |
|---|---|---|
| 日期格式 | ISO 8601 / 僅日期 / 本機 | ISO 8601 |
| 內嵌原生屬性 | 寫入 PDF 文件屬性 / Notion 資料庫屬性 | 開啟 |
Frontmatter 設定 — 基本資訊群組，帶切換開關
Frontmatter 設定 — 時間資訊群組
Frontmatter 設定 — AI 增強群組（功能）
每種匯出類型的輸出格式
Frontmatter 中繼資料可以 3 種格式輸出，由 metaOutputFormat 設定控制：
| 輸出格式 | 語法 | 用於 |
|---|---|---|
| YAML Frontmatter | ---\nkey: value\n--- | Markdown (.md) |
| 內嵌中繼資料 | **標籤:** 值 | Notion、TXT/MD |
| 純文字 | 標籤: 值 | TXT |
每種匯出格式（Markdown、TXT、PDF、Word、JSON、Notion、Clipboard）可透過 Frontmatter 區塊中的 輸出格式 切換獨立啟用或停用中繼資料。
輸出格式切換 — 按匯出格式啟用/停用中繼資料
啟用 YAML Frontmatter
YAML frontmatter 在啟用 AI 標籤與摘要時產生：
- 前往 設定 → 一般 → 🔗 AI 供應商
- 選擇供應商並輸入您的 API 金鑰
- 啟用 AI 標籤與摘要
- 匯出為 Markdown — frontmatter 會自動包含在內
在未啟用 AI 標籤的情況下，匯出仍然在最小的 frontmatter 區塊中包含基本中繼資料（日期、平台、模型）。
Frequently Asked Questions
可以切換個別 frontmatter 欄位嗎？+
可以。每個欄位（標題、conversation_id、platform、model、日期、字數、標籤、摘要等）都可以在 設定 → 一般 → Frontmatter 中個別切換開/關。
有哪些日期格式可用？+
三種格式：ISO 8601（2024-01-15T10:00:00Z）、僅日期（2024-01-15）和本機（2024/01/15 10:00）。
frontmatter 會影響 Markdown 的渲染嗎？+
不會。大多數 Markdown 渲染器預設會隱藏 frontmatter。它是中繼資料，不是可見內容。