obsidian-markdown

obsidian-markdown 技能使 AI 代理能夠在 Obsidian 知識庫中生成、格式化和操作筆記，並運用其專屬語法。此技能專為依賴 Obsidian 生態系統維護知識網絡的知識工作者、研究人員及寫作者所設計。透過區分標準 CommonMark/GFM 與 Obsidian 特有擴充功能，代理可以有效地管理知識庫檔案、內部參照與結構化元數據。此技能對於維護 Obsidian 內部的雙向連結與視覺組織功能至關重要。

• 完整支援維基連結 (wikilink) 語法，包括 [[筆記名稱]]、[[筆記名稱|顯示文字]]、標題連結以及透過 ^block-id 進行區塊層級引用。

• 先進的嵌入功能，可使用 ![[連結]] 語法嵌入圖像、PDF、音訊、影片及其他筆記內容。

• 透過 YAML 前置元數據 (properties) 進行結構化資料管理，支援文字、數字、日期、列表及布林核取方塊等類型。

• 利用提示框 (callouts) 進行區塊樣式設計，支援 note、tip、warning、danger 及 success 等多種類型，以提升筆記易讀性。

• 整合 LaTeX 數學公式、Mermaid 圖表繪製，以及用於內部備註的隱藏註解功能。

• 包含高亮文字、巢狀標籤及複雜註腳等格式擴充功能。

• 對於知識庫內部的連結，請優先使用維基連結 ([[...]])，以便利用 Obsidian 的自動重新命名與連結追蹤功能。

• 標準 Markdown 連結 文字 僅限用於外部網址，以區分本地知識庫結構與網路資源。

• 在建立筆記時，請在檔案頂部包含前置元數據，定義 tags、aliases 與 status 等關鍵屬性，確保筆記能在關係圖中被發現。

• 若使用 Mermaid 圖表或巢狀提示框等複雜嵌入內容，請務必保持正確的縮排與語法，以確保在 Obsidian 的閱讀模式下能正常呈現。

• 本技能預設使用者具備標準 Markdown 基礎，專注於處理將純文字檔案轉變為網路化知識體的「Obsidian 風格」層級。