obsidian-markdown skill 是什麼、怎麼安裝使用：讓 Claude Code 寫對 Obsidian 語法（雙鏈、嵌入、Callout、屬性）

本文根據 kepano/obsidian-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 9.0 萬次；所在倉庫 kepano/obsidian-skills 在 GitHub 約 4.9 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

讓智能體往 Obsidian 筆記庫裏寫筆記，標準 Markdown 它不會出錯，出錯的是 Obsidian 自己的那部分：把雙鏈寫成普通連結、嵌入語法少個感嘆號、Callout 的類型名瞎編、屬性區的 YAML 格式不對。obsidian-markdown 只管這一塊。description：創建和編輯帶有雙鏈（wikilinks）、嵌入、Callout、屬性及其他 Obsidian 特有語法的 Obsidian 風格 Markdown；處理 Obsidian 裏的 .md 文件，或用戶提到 wikilinks、callouts、frontmatter、標籤、嵌入、Obsidian 筆記時使用。

SKILL.md 說得很清楚：Obsidian 在 CommonMark 和 GFM 之上擴展了一批語法，這個技能只覆蓋 Obsidian 特有的擴展，標題、加粗、列表、表格這些標準寫法預設模型已經會。內容依次是：新建一篇筆記的流程（先在文件頂部加屬性區，寫標題、標籤、別名）、內部連結、嵌入、Callout、屬性、標籤、註釋、Obsidian 特有的格式、LaTeX 數學公式、Mermaid 圖、腳註，最後是一個完整示例。Callout、嵌入、屬性三塊各有一份更詳細的參考文件。

怎麼安裝

obsidian-markdown 隨 kepano/obsidian-skills 的 obsidian 插件一起安裝。Claude Code 裏輸入（命令來自倉庫 README）：

text
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

其他智能體用 npx skills add https://github.com/kepano/obsidian-skills，在選擇介面裏勾選 obsidian-markdown；也可以把倉庫裏的 skills/obsidian-markdown 文件夾直接複製到所用工具的技能目錄。

倉庫整體介紹和其他安裝方式，詳見本站《obsidian-skills 是什麼、怎麼安裝：Obsidian CEO kepano 寫的 Agent Skills，讓 Claude Code 讀寫 Obsidian 筆記庫》。

怎麼用

在筆記庫所在的文件夾裏啟動智能體：

• 「把這份會議記錄整理成一篇筆記，加上日期和參會人屬性，人名都做成雙鏈」。
• 「把這三篇筆記裏關於定價的段落嵌入到一篇彙總筆記裏」。
• 「把文中的注意事項改成 warning 類型的 Callout」。

適合誰 / 侷限

適合用 Obsidian 管理筆記、並希望 AI 幫忙批量整理和撰寫的人。它只保證語法正確，筆記怎麼組織、連結到哪篇仍取決於你的指示和庫裏已有的內容；依賴第三方插件的語法（如 Dataview 查詢）不在覆蓋範圍內。

注意事項

• 許可：MIT。
• 不執行腳本、不聯網：純格式說明；但智能體會直接改寫你的筆記文件，批量操作前先備份或用 git 管理筆記庫。
• 這是該庫在 skills.sh 當日榜單上安裝量最高的技能。