Documentation

結構化中繼資料 — 每次匯出都是知識資產

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 範例,包含所有欄位
完整的 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 設定 — 時間資訊群組
Frontmatter 設定 — 時間資訊群組
Frontmatter 設定 — AI 增強群組(功能)
Frontmatter 設定 — AI 增強群組(功能)

每種匯出類型的輸出格式

中繼資料格式由匯出目標自動決定,沒有手動選擇格式的選項:

匯出格式中繼資料語法說明
Markdown (.md)YAML Frontmatter ---\nkey: value\n---行業標準,相容於 Obsidian / Hugo / Jekyll
Notion內嵌格式 **標籤:** 值Notion 不支援 YAML frontmatter
純文字 (.txt)純文字 標籤: 值無特殊語法,純可讀文字
PDF / Word視覺化 HTML 資訊塊在文件頭部渲染為格式化的中繼資料表格

你可以在 Frontmatter 設定中使用 OUTPUT FORMATS 開關,獨立控制每種匯出格式(Markdown、TXT、PDF、Word、JSON、Notion、Clipboard)是否包含中繼資料。

輸出格式切換 — 按匯出格式啟用/停用中繼資料
輸出格式切換 — 按匯出格式啟用/停用中繼資料

啟用 YAML Frontmatter

YAML frontmatter 在啟用 AI 標籤與摘要時產生:

  1. 前往 設定 → 一般 → 🔗 AI 供應商
  2. 選擇供應商並輸入您的 API 金鑰
  3. 啟用 AI 標籤與摘要
  4. 匯出為 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。它是中繼資料,不是可見內容。

Related Articles