官方網站
Git 儲存庫產品說明
Foam 是一款開源的個人知識管理工具，它並非獨立的應用程式，而是由一系列 Visual Studio Code 擴充功能組合而成的生態系統。對於習慣於 VS Code 介面、依賴 Markdown 並希望透過 Git 進行版本控制的開發者或作家來說，Foam 是 Roam Research 或 Obsidian 的極佳替代方案。
Foam 的核心理念是「筆記即程式碼」。它透過雙向連結（Backlinks）與圖譜檢視（Graph View），將原本破碎的 Markdown 檔案編織成一個互聯的知識網。由於它直接運行在 VS Code 中，你可以同時享受強大的語法高亮、終端機整合以及無窮無盡的擴充插件支援，讓你的知識庫與開發環境融為一體。
核心特色：
- 無縫 VS Code 整合：如果你已經在使用 VS Code，使用 Foam 幾乎不需要任何學習成本。
- 圖譜視覺化 (Graph View)：內建視覺化導航，清楚呈現筆記之間的關聯性，幫助你發現知識的潛在連結。
- 完全本地與私有：所有的筆記都只是 Markdown 檔案，你可以使用 Git、Dropbox 或任何方式進行備份，完全掌握資料所有權。
- 快速導航與補全：支援
[[wiki-links]]語法，並在輸入時提供智慧型自動補全與即時預覽。
常用指令
Foam 的操作主要依賴 VS Code 的命令面板（Command Palette）以及 Markdown 語法擴展。
啟動與基礎操作
# 推薦方式：從官方模板建立你的 Foam 儲存庫
# 1. 訪問 [https://github.com/foambubble/foam-template](https://github.com/foambubble/foam-template)
# 2. 點擊 "Use this template"
# 3. 複製到本地並在 VS Code 中開啟
# 在命令面板 (Ctrl+Shift+P) 中常用指令：
> Foam: Open Daily Note # 建立或開啟今日日記
> Foam: Show Graph # 開啟知識圖譜視覺化
> Foam: Create New Note # 快速建立新筆記
| 快速操作 / 語法 | 功能說明 | 適用情境 |
|---|---|---|
| [[Note Name]] | 建立雙向連結 | 跨檔案引用知識點 |
| Alt + Click | 跳轉至連結目標 | 快速在筆記間移動 |
| Ctrl + Shift + V | 預覽 Markdown 渲染 | 檢查排版結果 |
| Git Push | 同步與備份 | 將筆記庫上傳至 GitHub 私人儲存庫 |
| Placeholders | 自動補全檔案標題 | 節省輸入時間並保持結構一致 |
進階技巧
自定義圖譜樣式：你可以透過修改 VS Code 的設定檔，自定義圖譜節點的顏色、大小與吸引力模型，打造個人化的知識星系。
整合 GitHub Actions：設定自動化流程，當你將筆記推送到 GitHub 時，自動將其發布成靜態網站（如使用 Jekyll 或 Hugo）。
跨平台編輯：結合 VS Code 的 Web 版 (vscode.dev)，你可以在任何瀏覽器中登入 GitHub 並直接修改你的 Foam 筆記庫。
操作介面
