🔧 阿川の電商水電行
Shopify 顧問、維護與客製化
💡
小任務 / 單次支援方案
單次處理 Shopify 修正/微調
⭐️
維護方案
每月 Shopify 技術支援 + 小修改 + 諮詢
🚀
專案建置
Shopify 功能導入、培訓 + 分階段交付

Obsidian 是什麼

這是一款可以查看和編輯 Markdown 檔案的桌面應用程式。
也有手機應用程式 (iOS/Android)。
Obsidian 官方網站

  • 具體來說,將存放 Markdown 檔案的目錄(也可以是子目錄)讓 Obsidian 認識為 Vault(保管庫),即可像瀏覽網站一樣,在應用程式上按照階層結構查看已渲染的每個檔案。此外,還可以在應用程式上編輯每個頁面,或新建檔案和目錄。換句話說,可以在本地構建個人維基。
  • 還有同步功能(付費的官方功能 Obsidian Sync 或可免費試用的外部儲存串接插件 Remotely Save),透過同步可以在其他電腦、智能手機或平板電腦上查看和編輯個人維基。[^1]

與其他設備間連結 Markdown 文檔的手段相比,

  • 若僅以 Markdown 進行筆記,可以建立 GitHub(私人)倉庫並放置 Markdown 檔案,然後從 GitHub 查看,這也能達成相同目的,但每次編輯都需要伴隨 git commit,且我認為 Obsidian 在新建檔案或目錄方面的操作更無縫。
    • 此外,如果將上述方法結合 Markdown 構建工具(如 MkDocs)或 Markdown 渲染庫(如 TeXMe),可在 GitHub Pages 或一般網站伺服器上進行託管,對於他人的正式文檔(如套件文件或公開維基)是適合的,但對於個人筆記用途而言,操作會顯得不夠無縫。
  • 也有 GitHub Wiki,但這不支持階層結構(必須巧妙設計標題和鏈接來模擬)。此外,Claude Code 串接(後述)也相對麻煩。
  • 作為個人用筆記,也有 Simplenote 等可進行設備間連結且支持 Markdown 的選擇,但這也不支持階層結構,且 Claude Code 串接也是繁瑣的。

Obsidian 我個人認為方便的使用方式

1. 將 Claude Code 的問題與回答保存在 Vault 內查看

  • 方法:

  • 優點:

    • Markdown 被渲染後,更易於查看。
    • 如果不再參考的內容可以刪除,而需要處理的內容可以保存。
    • 在提問的時候創建檔案並在開頭寫下問題,等到回答完成時再補充,這樣可以知道 Obsidian 上回答是否已完成(當在 Obsidian 打開頁面時即可自動反映)。
    • 我相信有些人會在 Claude 的回答完成時設定鈴聲,但透過這個方法,若在提更多問題後外出,可以在電車上從智能手機查看內容(需要將 Obsidian 與智能手機連接)。
      • 進一步能從智能手機進行附加問題會更方便,但我尚未做到那一步。

2. 讓 Claude Code 協助撰寫、審核和修修改文書

這部分與標題一致。Obsidian 中的頁面實際是本地的 Markdown 檔案,因此可以輕鬆使用 Claude Code CLI 協助撰寫、審核和修正文書。[^2]

3. 作為看板運用

  • 方法:

    • 在 Vault 中任意一個目錄下創建 Not Started/In Progress/Completed/Archived/ 等資料夾,將任務文件(例如將檔案名稱設為任務名稱)放入其中,即可進行個人任務管理。可以輕鬆地在應用中將檔案移動到不同的資料夾。檔案內容可以隨心所欲地撰寫。
  • 便利的點:

    • 可以與使用法 2 結合,獲取 Claude Code 的建議和協助。
    • 在 README.md 中記錄任務列表和截止日期,可以用腳本檢查 README 與各檔案之間的一致性,或發出「截止日期將近但尚未開始」的警告 (腳本範例)。
./DropBox/obsidian/MyVault/TaskManagement/  # 範例
├─ validate.py  # 任務驗證腳本
├─ README.md  # 記錄任務列表
└─ Tasks/
   ├─ Not Started/*.md  # 未開始的任務
   ├─ In Progress/*.md  # 進行中的任務
   ├─ Completed/*.md  # 完成的任務
   └─ Archived/*.md  # 已歸檔的任務

4. 作為 Zotero 的附件檔案保存位置

我相信有些人利用 Zotero 來進行文獻管理。可以將 Zotero 作為文獻的初步接收端,並在 Obsidian 中進行瀏覽和記錄的運用方式。
已經在使用 ZotMoov 插件的人,這樣的運作會更方便。[^4]

  • 方法:

    • 使用 Zotero 插件 ZotMoov,將附件檔案的保存位置和 ZotMoov 的移動位置設為 Obsidian 的 Vault 中的資料夾。
  • 優點:

    • 可以在 Obsidian 中查看 PDF(目前 Obsidian 預設可顯示 PDF,無需勾選「允許所有副檔名」)。
    • 因此,例如可將 Zotero 僅安裝於 PC1,並將 PDF 移動到 Dropbox 下的 Vault 中,則可在 PC2 和智能手機的 Obsidian 中查看文獻 PDF。
    • 在文獻 PDF 旁有個 相同檔名.md(例如)記錄書誌資訊和自己的備註,當完全理解或覺得不需要時可以從 Zotero 中刪除 PDF,從而保持 Zotero 與 Dropbox 的空間精簡。
    • 當然,可以與使用法 2 結合,讓 Claude Code 審核文獻備註或從一開始撰寫文獻備註。

附贈:Obsidian 顯示相關的技巧

  • Obsidian 會在開頭顯示檔名,且這與級別 1 的標題使用相同的字型大小和字重,因此想要額外撰寫級別 1 的標題的人可能會覺得不自在。若是如此,可以在 CSS 中撰寫將檔名字型變得淡薄小巧(如下所示的 MyVault/.obsidian/snippets/custom.css),再在「設定 > 外觀」最下方的「CSS 簡碼」中啟用,便會生效。[^5][^6]

  • Obsidian 支持 GitHub 的警告記法(如下)。手邊:

    • [^Note][^任何詞語] 會變成淡藍色的方塊。
    • [^Tip][^Important] 會變成淡綠色的方塊。
    • [^Warning][^Caution] 會變成淡橙色的方塊。
MyVault/.obsidian/snippets/custom.css
.inline-title {
  color: darkgrey;  /* 淡化顏色 */
  font-size: 1.25rem !important;  /* 調小字型大小 */
  margin-bottom: 1rem;  /* 下方留白 */
}
GitHub 的警告記法
> [!範例]
> 內容描述

[^1]:我使用 Remotely Save 將外部儲存設為 Dropbox,並與兩台電腦和智能手機進行連結(不過免費版 Dropbox 可以安裝的設備限三台,所以如需更多連結需要其他方法或需付費版 Dropbox)。 ↩
[^2]:另,Windows 裝置的使用者可以使用 MS Copilot 查看本地檔案,但目前 MS Copilot 無法閱讀副檔名為 .md 的檔案,因此在查看之前需轉換為 .txt,且必須指定具體檔案名稱(至少在我手頭上,無法指示 MS Copilot 「請審查此目錄下的內容」)。如果希望調動 MS Copilot 編輯,也可以寫編寫副檔名批量轉換和檔案路徑列舉腳本來實現,但在副檔名為 .txt 時無法從 Obsidian 查看。順便提一下,批量變更副檔名的腳本在此。 ↩
[^3]:選擇外部儲存的話似乎也可以進行團隊的任務管理,但若是團隊的話,通過 GitHub 看板或其他現有服務進行任務管理參與成本和管理成本會更低的。 ↩
[^4]:將 PDF 保存目錄移至 Vault 之下後啟動 Zotero,然後重新設置「編輯 > 設定」中的「詳細」選項卡的「基本目錄」和「ZotMoov」選項卡的「Directory to Move」。 ↩
[^5]:如果已經應用其他主題,此 CSS 可能無法生效。 ↩


原文出處:https://qiita.com/CookieBox26/items/82c606539cc4fe31e2b9


精選技術文章翻譯,幫助開發者持續吸收新知。

共有 0 則留言


精選技術文章翻譯,幫助開發者持續吸收新知。
🏆 本月排行榜
🥇
站長阿川
📝7   💬9   ❤️1
192
🥈
我愛JS
📝1   💬3   ❤️2
48
評分標準:發文×10 + 留言×3 + 獲讚×5 + 點讚×1 + 瀏覽數÷10
本數據每小時更新一次
🔧 阿川の電商水電行
Shopify 顧問、維護與客製化
💡
小任務 / 單次支援方案
單次處理 Shopify 修正/微調
⭐️
維護方案
每月 Shopify 技術支援 + 小修改 + 諮詢
🚀
專案建置
Shopify 功能導入、培訓 + 分階段交付