0基礎玩轉obsidian：AI時代必備本地知識庫工具

大家好，我係噪點

上篇分享咗 karpathy 提出嘅 AI 時代知識庫管理新範式 llm wiki，我用 AI 復活咗散落咗 10 年嘅筆記：Karpathy 方法實測入面有簡單提到筆記管理工具 obsidian。

今日就專登傾下呢個工具，算係一篇完整嘅入門指南0 基礎嘅朋友睇完都可以直接上手。

講真，如果係一年前，我其實唔推薦用 obsidian，因為當時 agent 嘅能力仲未成熟；如果純靠人力去維護筆記，obsidian 相比飛書文檔、印象筆記、備忘錄呢啲，體感上都係太重，門檻高，我都係用咗一段時間之後放棄咗。

但今年情況唔同曬，codex、claude code、openclaw、hermes 呢啲 agent 一個比一個成熟同能打，做知識庫呢件事嘅最優解被徹底改寫咗；obsidian 都一下子由「重工具」變咗做 AI 時代非常合適嘅本地知識庫底座。

傾佢之前，先講下筆記呢件事嘅真實痛點。

我自己十幾年嘅筆記，散喺飛書、印象筆記、備忘錄、word 文檔等一堆地方，因為各種奇奇怪怪嘅問題啦，基本上係用一排換一個。筆記的確都記低咗，但每次想揾返對應嘅具體內容都要反覆切工具搜，揾一篇舊筆記好似玩尋寶咁。

更慘嘅係，有啲雲端工具嘅數據係被綁死嘅，想遷出嚟非常麻煩，甚至格式唔通用，所以我一直想揾一個可以將所有筆記統一管理、永遠喺自己手度嘅本地知識庫工具。

obsidian 就係呢個答案。

都係跟返老習慣，先由係乜嘢講起，再分享具體步驟；會從 obsidian 係咩、下載同上手、必備 skill、插件推薦 4 部分展開。

通俗啲講，obsidian 就係一個完全免費嘅本地 markdown 筆記軟件。

入面所有筆記都係一個個 .md 純文本文件，存在我哋自己電腦嘅某個文件夾入面。即係話就算有一日 obsidian 冇咗，都唔會影響文件夾，筆記一啲都唔會唔見。

佢有 4 個我特別鍾意嘅點。

完全本地：同啲在線筆記工具唔同，obsidian 唔依賴任何雲服務，斷咗網都用得，數據完全係你自己嘅。

markdown 純文本：所有筆記都係純文本格式，agent、AI 工具、任何文本編輯器都可以直接讀寫，呢個係 AI 時代揀工具嘅關鍵。

雙鏈：喺一篇筆記入面寫[[某個筆記名]]就可以跳過去，等於自動幫你嘅筆記建立咗關係網，越用就越睇到知識之間嘅連接脈絡。

插件生態：基礎功能其實好簡單，但靠社區插件可以實現好多複雜功能同玩法。

呢個就係點解我話 AI 時代 obsidian 特別適合：因為本地 + 純文本 + 文件夾呢三個特性疊加，agent 就可以直接好似打開文件夾咁讀寫我哋嘅筆記。vault 就係佢嘅工作目錄，文件就係數據，冇比呢個更加原生嘅配合方式喇。

直接入官網揀版本下載就得：

https://obsidian.md/

打開之後會叫你建立一個 vault。

vault 通俗啲講就係 obsidian 嘅「工作倉庫」，本質就係你電腦上嘅一個普通文件夾，所有筆記、設置、插件都喺呢一個文件夾入面。

呢度有個建議：成個 obsidian 建立一個 vault 就夠。

我見到有啲朋友會按「工作」、「個人」、「創業」開好幾個 vault，呢個反而唔建議。

一來係插件同主題設置都跟住 vault 走嘅，開幾個 vault 就要重複配幾次，更新一次插件要㩒幾次，維護成本好高；

另一個更加主要嘅係，obsidian 嘅靈魂係雙鏈，但雙鏈唔可以跨 vault，一旦分庫，本來可以連埋一齊嘅筆記就變咗一個個孤島，越分越散。

所以建議直接建立一個 vault，再用子文件夾分類就得。

入咗 vault 之後，建立一篇新筆記，輸入[[ 就會自動彈出已有筆記嘅下拉選單，揀一個就完成咗雙鏈。㩒擊雙鏈可以直接跳過去。呢個係成個 obsidian 最核心嘅體驗之一喇。

vault 建立好咗，仲需要裝一啲用 obsidian 嘅必備 skill，等 agent 知道點樣同你嘅 vault 工作。

obsidian 有個官方 skill 庫，係 obsidian 創辦人 kepano 自己維護嘅，可以放心用。

地址：

https://github.com/kepano/obsidian-skills

入面一共有 5 個 skill，建議全部裝曬。

obsidian-cli：令 agent 可以透過終端命令行直接操作 vault，唔需要打開 obsidian 軟件就可以讀寫筆記、搜索、建立文件夾。

obsidian-bases：教 agent 寫 .base 檔案，類似 notion 嘅數據庫視圖，可以做表格、篩選、公式等。

json-canvas：教 agent 寫 .canvas 無限畫布檔案，做思維導圖、流程圖、白板呢類內容。

obsidian-markdown：教 agent 寫 obsidian 風格嘅 markdown，包括雙鏈、callout 等呢啲專屬語法，令 agent 寫出嚟嘅筆記同手寫嘅格式一致。

defuddle：令 agent 從網頁抓乾淨嘅 markdown 內容 feed 入 vault，比直接複製網頁慳 token。

呢 5 個 skill 可以用下面一行命令直接搞掂：

npx skills add git@github.com:kepano/obsidian-skills.git

裝好之後喺 claude code 等 agent 入面直接叫用就得，agent 會自己根據任務揀合適嘅 skill。

obsidian 嘅插件市場可以話係佢嘅靈魂之一幾千個插件，按需要裝就得。

通用插件嘅安裝路徑好簡單：設置 → 第三方插件 → 關閉安全模式 → 瀏覽社區插件市場 → 搜索想要嘅插件 → 安裝 → 啓用就得。

呢度就唔一一列舉喇，每個人需要唔同，大家自己去插件市場行一圈按需要裝就得。

只係講一個插件，claudian呢個係 obsidian 比較火嘅一個 AI 插件，目前已經有 10k+ stars。

佢嘅核心定位係將 claude code、codex、opencode 呢啲 AI agent 直接嵌入 obsidian，vault 直接變成 agent 嘅工作目錄。簡單理解就係唔使開終端、唔使切窗口，你就可以直接喺 obsidian 側邊欄入面使用 claude code、codex 等，呢啲 agent 可以讀你嘅筆記、改你嘅筆記、跨檔案搜索、執行命令。

幾個我用落覺得好爽嘅點。

側邊欄傾偈：直接同 agent 對話，唔使開終端，寫筆記嘅時候隨問隨改。

inline edit：揀中一段文字㩒快捷鍵，agent 可以直接修改，仲有 diff 預覽，前後修改一清二楚。

@mention：輸入@可以引用 vault 入面任何檔案、subagent、mcp 服務等，俾 agent 上下文非常方便。

可以直接將下面項目連結掟俾常用嘅 agent，等 AI 幫手安裝，非常方便。

地址：

https://github.com/YishenTu/claudian

成套裝曬落嚟，我最直接嘅感受就係：以前嘅筆記軟件係俾人睇嘅，obsidian 係俾人同 AI 一齊睇嘅。

我哋之前花好多時間喺寫 claude.md 教 AI 點樣做嘢，但 AI 仲需要一個可以持續讀、持續寫嘅本地知識庫，咁先可以真正長期幫我哋沉澱嘢。

obsidian 喺呢件事上，目前係我個人覺得非常合適嘅方案。

本地、純文本、文件夾結構、插件生態，都可以匹配現時 AI 時代嘅要求。

如果未用過 obsidian 嘅朋友，可以直接花十分鐘裝一裝，先將 vault 建立好，再將 5 個 skill 裝曬，成個底座就建立好喇。

後面無論係整 wiki、寫文件、整理資料，都可以直接喺呢套底座基礎上整，真係會越用越方便。

對 AI 工具、AI 乾貨技巧、vibe coding感興趣，可以俾『噪點』加個星標 ⭐️第一時間獲取推送！都歡迎交個朋友～

大家好，我是噪點

上篇分享了 karpathy 提的 ai 時代知識庫管理新範式 llm wiki，我用AI復活了散落 10 年的筆記：Karpathy 方法實測，裏面有簡單提到筆記管理工具 obsidian。

今天就來專門聊聊這個工具，算是一篇完整的入門指南，0 基礎朋友看完也可以直接上手。

說實話，如果是一年前，我倒並不推薦用 obsidian，因為當時 agent 能力還不成熟；如果純靠人力去維護筆記，obsidian 相比飛書文檔、印象筆記、備忘錄這些，體感上還是太重了，門檻高，我也是用一段時間後放棄了。

但今年情況不一樣了，codex、claude code、openclaw、hermes 這些 agent 一個比一個成熟能打，做知識庫這件事的最優解被徹底改寫了；obsidian 也一下子從"重工具"變成了 ai 時代非常合適的本地知識庫底座。

聊它之前，先說下筆記這件事的真實痛點。

我自己十多年的筆記，散在飛書、印象筆記、備忘錄、word 文檔等一堆地方，因為各種奇奇怪怪的問題吧，基本上是用一陣換一個。筆記確實都記下來了，但每次想找對應具體內容都得反覆切工具搜，找一篇舊筆記跟玩尋寶一樣。

更要命的是，有些雲端工具數據是被綁死的，想遷出來非常麻煩，甚至格式不通用，所以我一直想找一個能把所有筆記統一管起來、永遠在自己手裏的本地知識庫工具。

obsidian 就是這個答案。

還是按老習慣，先從是什麼講起，再分享具體步驟；會從 obsidian 是什麼、下載和上手、必備 skill、插件推薦 4 部分展開。

大白話說，obsidian 就是一個完全免費的本地 markdown 筆記軟件。

裏面所有筆記都是一個個 .md 純文本文件，存在我們自己電腦的某個文件夾裏。也就是說哪怕某天 obsidian 沒了，也不影響文件夾，筆記一點兒也不會丟。

它有 4 個我特別喜歡的點。

完全本地：和一些在線筆記工具不一樣，obsidian 不依賴任何雲服務，斷網也能用，數據完全是你自己的。

markdown 純文本：所有筆記都是純文本格式，agent、ai 工具、任何文本編輯器都能直接讀寫，這個是 ai 時代選擇工具的關鍵。

雙鏈：在一篇筆記裏寫[[某個筆記名]]就能跳過去，等於自動給你的筆記建了關係網，越用越能看出知識之間的連接脈絡。

插件生態：基礎功能其實很簡單，但靠社區插件可以實現非常多的複雜功能和玩法。

這也就是為什麼我說 ai 時代 obsidian 特別合適：因為本地 + 純文本 + 文件夾這三個特性疊加，agent 就可以直接像翻文件夾一樣讀寫我們的筆記。vault 就是它的工作目錄，文件就是數據，沒有比這更原生的配合方式了。

直接進官網選擇版本下載即可：

https://obsidian.md/

打開後會讓你先建一個 vault。

vault 大白話就是 obsidian 的"工作倉庫"，本質就是你電腦上的一個普通文件夾，所有筆記、設置、插件都在這一個文件夾裏。

這裏有個建議：整個 obsidian 建一個 vault 就夠了。

我看到有些朋友會按"工作"、"個人"、"創業"開好幾個 vault，這倒反而不建議。

一個是插件和主題設置都跟着 vault 走的，開幾個 vault 就要重複配幾遍，更新一次插件要點幾次，維護成本很高；

另一個更主要的是，obsidian 的靈魂是雙鏈，但雙鏈不能跨 vault，一旦分庫，本來可以連起來的筆記就成了一個個孤島，越分越散。

所以建議直接建一個 vault，再用子文件夾分類就行。

進入 vault 後，新建一篇筆記，輸入[[ 就會自動出現已有筆記的下拉，選一個就完成了雙鏈。點擊雙鏈可以直接跳過去。這是整個 obsidian 最核心的體驗之一了。

vault 建好了，還需要再裝一些使用 obsidian 的必備 skill，讓 agent 知道怎麼和你的 vault 工作。

obsidian 有個官方 skill 庫，是 obsidian 創始人 kepano 自己維護的，可以放心用。

地址：

https://github.com/kepano/obsidian-skills

裏面一共 5 個 skill，建議全部裝上。

obsidian-cli：讓 agent 通過終端命令行直接操作 vault，不需要打開 obsidian 軟件就能讀寫筆記、搜索、建文件夾。

obsidian-bases：教 agent 寫 .base 文件，類似 notion 的數據庫視圖，可以做表格、篩選、公式等。

json-canvas：教 agent 寫 .canvas 無限畫布文件，做思維導圖、流程圖、白板這類內容。

obsidian-markdown：教 agent 寫 obsidian 風格的 markdown，包括雙鏈、callout 等這些專屬語法，讓 agent 寫出來的筆記和手寫的格式一致。

defuddle：讓 agent 從網頁抓乾淨的 markdown 內容喂進 vault，比直接複製網頁省 token。

這 5 個 skill 可以下方一行命令直接搞定：

npx skills add git@github.com:kepano/obsidian-skills.git

裝好後在 claude code 等 agent 裏直接調用即可，agent 會自己根據任務挑合適的 skill。

obsidian 的插件市場可以說是它的靈魂之一，幾千個插件，按需求裝就行。

通用插件的安裝路徑很簡單：設置 → 第三方插件 → 關閉安全模式 → 瀏覽社區插件市場 → 搜索想要的插件 → 安裝 → 啓用即可。

這裏就不一一列舉了，每個人需求不一樣，大家自己去插件市場逛一圈按需裝即可。

就只講一個插件，claudian，這是 obsidian 比較火的一個 ai 插件，目前已經 10k+ stars。

它的核心定位是把 claude code、codex、opencode 這些 ai agent 直接嵌進 obsidian，vault 直接變成 agent 的工作目錄。簡單理解就是不用開終端、不用切窗口，你就能直接在 obsidian 側邊欄裏使用claude code、codex等，這些agent可以讀你的筆記、改你的筆記、跨文件搜索、跑命令。

幾個我用下來覺得很爽的點。

側邊欄聊天：直接和 agent 對話，不用開終端，寫筆記的時候隨問隨改。

inline edit：選中一段文字按快捷鍵，agent 可直接修改，還有 diff 預覽，前後修改一目瞭然。

@mention：輸入@可以引用 vault 裏任何文件、subagent、mcp 服務等，給 agent 上下文非常方便。

可以直接將下面項目連結丟給常用的 agent，讓 ai 幫忙安裝，非常方便。

地址：

https://github.com/YishenTu/claudian

整套裝下來，我最直觀的感受就是：以前的筆記軟件是給人看的，obsidian 是給人和 ai 一起看的。

我們之前花很多時間在寫 claude.md 教 ai 怎麼幹活，但 ai 還需要一個能持續讀、持續寫的本地知識庫，這樣才能真正長期幫我們沉澱東西。

obsidian 在這件事上，目前是我個人覺得非常合適的方案。

本地、純文本、文件夾結構、插件生態，都能匹配現在 ai 時代的要求。

如果還沒用過 obsidian 的朋友，可以直接花十分鐘裝一下，先把 vault 建起來，再把 5 個 skill 裝上，整個底座就建好了。

後面無論是搭 wiki、寫文檔、整理資料，都可以直接在這套底座基礎上搭，真的會越用越方便。

對AI工具、AI乾貨技巧、vibe coding感興趣，可以給『噪點』加個星標 ⭐️，第一時間獲取推送！也歡迎交個朋友～