術語表
TypeMD 文件、CLI 和設定檔中使用的術語快速參考。
由 TypeMD 管理的目錄。包含 .typemd/（設定）、objects/（內容），以及選填的 templates/（object template）。每個 Vault 都是獨立的，可以用版本控制管理。
Object（物件）
Section titled “Object（物件）”TypeMD 中知識的基本單位。你不需要用「檔案」或「筆記」來思考，而是用物件——一本書、一個人、一個想法、一場會議。每個物件是一個 Markdown 檔案，包含 YAML frontmatter（屬性）和自由格式的內文。
Type（類型）
Section titled “Type（類型）”定義你要建立什麼樣的物件。每個物件只屬於一個類型（例如 book、person、note）。類型由 types/ 中的 YAML schema 檔案定義。可選的 schema 欄位包含 plural（集合情境的複數顯示名稱）、emoji、color、description、version 和 unique。
Property（屬性）
Section titled “Property（屬性）”物件上的具名欄位，由 Type schema 定義。屬性有型別（string、number、date、select、relation 等），儲存在 YAML frontmatter 中。屬性可以有 emoji、pin、default 等附加設定。
Relation（關聯）
Section titled “Relation（關聯）”兩個物件之間具名且帶型別的連結。不同於簡單的超連結，關聯定義在 Type schema 中，可以設定為雙向——更新一端會自動更新另一端。
Link（連結）
Section titled “Link（連結）”在 Markdown 內文中使用 wiki-link 語法（[[...]]）引用其他物件的方式。TypeMD 會追蹤這些連結及其反向連結（backlink）。也稱為 wiki-link。
Backlink（反向連結）
Section titled “Backlink（反向連結）”從連結自動計算的反向參照。如果物件 A 連結到物件 B，則 B 有一個來自 A 的反向連結。反向連結是唯讀的，由索引自動維護。
Tag（標籤）
Section titled “Tag（標籤）”內建 tag 類型的物件。標籤強制 name 唯一性，可以透過 tags 系統屬性連結到任何物件。標籤支援 color 和 icon 屬性。
Template（模板）
Section titled “Template（模板）”建立新物件時提供預設 frontmatter 和內文。Object template 以 Markdown 檔案儲存在 templates/<type>/ 中。Name template 使用 {{ date:FORMAT }} 語法自動產生物件名稱。
View（檢視）
Section titled “View（檢視）”已儲存的設定，控制某個 Type 的物件如何顯示 — 包含排序順序、篩選規則、分組和佈局。View 以 YAML 檔案儲存在 types/<name>/views/。每個 Type 都有一個隱含的預設 View（list 佈局，按 name 排序）。
物件檔名中人類可讀的部分。例如 book/golang-in-action-01jqr3k5mpbvn8e0f2g7h9txyz.md 中的 golang-in-action。來自建立物件時提供的名稱。
建立物件時使用自然語言名稱（例如 “Clean Code”），TypeMD 會依以下規則轉換為 slug：
- 轉換為小寫
- 空格和底線替換為連字號
- 移除非字母、數字和連字號的字元（CJK 和帶重音的 Unicode 字母會保留）
- 將連續的連字號合併為單一連字號
- 去除開頭和結尾的連字號
| 輸入 | Slug |
|---|---|
Clean Code | clean-code |
What's the plan? | whats-the-plan |
my_great_idea | my-great-idea |
Chapter 3 Notes | chapter-3-notes |
clean-code | clean-code（已是合法格式） |
原始輸入一律保留在 name 屬性中——slug 轉換只影響檔名。
26 字元的通用唯一且可按字典序排列的識別碼（Universally Unique Lexicographically Sortable Identifier），由 CLI 自動附加在 slug 後方。確保即使 slug 相同也不會衝突。手動建立的物件不需要 ULID。
Object ID
Section titled “Object ID”物件的完整識別碼，格式為 type/slug-ulid。例如：book/golang-in-action-01jqr3k5mpbvn8e0f2g7h9txyz。用於連結目標和關聯參照。
Display ID
Section titled “Display ID”Object ID 去除 ULID 後綴的人類可讀形式。例如：從 book/golang-in-action-01jqr3k5mpbvn8e0f2g7h9txyz 得到 book/golang-in-action。用於渲染沒有顯示文字的 wiki-link。
Frontmatter
Section titled “Frontmatter”物件檔案頂部的 YAML 中繼資料區塊，以 --- 分隔。依固定順序包含屬性：系統屬性在前，schema 定義的屬性在後。
Index（索引）
Section titled “Index（索引）”SQLite 資料庫（.typemd/index.db），快取物件中繼資料以供快速查詢和全文搜尋。自動建立和更新，不需要手動編輯。
Sync（同步）
Section titled “Sync（同步）”讀取物件檔案並更新索引的過程。開啟 Vault 時自動發生。同步時會補上缺少的 name 屬性、解析標籤參照、並重新整理搜尋索引。
Validation（驗證）
Section titled “Validation（驗證）”檢查 schema、物件、關聯、連結和 name 唯一性約束是否正確。使用 tmd type validate 執行。