Tolaria 完全指南 2026：開源 Markdown 知識庫桌面應用

Tolaria 是什麼？

Tolaria 是一個開源的桌面應用，用於管理 Markdown 格式的知識庫。它由開發者 Luca Ronin 建立，最初是為了管理他自己超過 10,000 條筆記的個人工作空間而開發的，現在已成長為 GitHub 上 14,000+ stars 的熱門專案。

核心理念

Tolaria 的設計哲學非常明確：你的資料屬於你，不屬於任何應用。這與 Obsidian、Notion 等主流筆記工具有本質區別：

特性	Tolaria	Obsidian	Notion
檔案格式	純 Markdown + YAML frontmatter	純 Markdown	專有資料庫
資料儲存	本機資料夾（Git 儲存庫）	本機資料夾	雲端伺服器
離線可用	✅ 完全離線	✅ 完全離線	❌ 需要網路
Git 整合	🎯 內建 Git 支援	需外掛	不支援
AI 友好	✅ 原生支援 Claude Code/Codex/Gemini CLI	需外掛	API 有限
價格	🆓 完全免費開源	免費版 + 付費同步	免費版 + 訂閱制
平台	macOS / Windows / Linux	macOS / Windows / Linux / Mobile	Web / Mobile

為什麼選擇 Tolaria？

1. 零鎖定（Zero Lock-in）：所有筆記都是標準的 .md 檔案，隨時可以用 VS Code、Vim 或其他編輯器開啟。即使你停止使用 Tolaria，也不會遺失任何資料。

2. Git 優先（Git-first）：每個知識庫（Vault）都是一個 Git 儲存庫，自動獲得版本歷史、分支管理、遠端同步能力。這對於團隊協作或長期知識積累至關重要。

3. AI 原生支援：Tolaria 內建了對 Claude Code、Codex CLI、Gemini CLI 的支援，並提供 AGENTS 檔案幫助 AI 助手理解你的知識庫結構。

4. 鍵盤優先設計：為高效使用者設計，大量操作可透過快捷鍵完成，Command Palette 類似 VS Code 的體驗。

5. 類型即透鏡（Types as Lenses）：Tolaria 的類型系統不是強制性的 schema，而是幫助你導航和分類筆記的輔助工具，沒有必填欄位或驗證限制。

---

安裝 Tolaria

macOS（推薦 Homebrew）

# 透過 Homebrew 安裝（最簡單）
brew install --cask tolaria

# 或者從官網下載
# 訪問 https://refactoringhq.github.io/tolaria/download/

Windows

1. 訪問 Tolaria 下載頁面
2. 下載最新的 .exe 安裝包
3. 執行安裝程式

注意：Windows 安裝包已進行 Authenticode 簽名，但在公司管理的裝置上可能仍需 IT 部門批准首次安裝。

Linux

# 下載 AppImage（推薦）
wget https://github.com/refactoringhq/tolaria/releases/latest/download/Tolaria-x86_64.AppImage
chmod +x Tolaria-x86_64.AppImage
./Tolaria-x86_64.AppImage

# 或者使用 Flatpak（如果可用）
flatpak install flathub com.refactoringhq.tolaria

從原始碼建置

# 複製儲存庫
git clone https://github.com/refactoringhq/tolaria.git
cd tolaria

# 安裝相依套件（需要 Node.js 18+）
npm install

# 開發模式執行
npm run dev

# 建置正式版
npm run build

---

快速上手：建立第一個知識庫

Step 1：初始化 Vault

首次啟動 Tolaria 時，你可以選擇：

1. 複製入門知識庫：Tolaria 提供了一個 getting started vault，包含範例筆記和使用教學
2. 建立空白知識庫：從零開始
3. 開啟現有資料夾：如果你已有 Markdown 筆記資料夾，可以直接匯入

# 手動建立空白 vault（命令列方式）
mkdir ~/my-knowledge-base
cd ~/my-knowledge-base
git init
echo "# My Knowledge Base" > README.md
git add .
git commit -m "Initial commit"

然後在 Tolaria 中選擇「Open Existing Vault」指向這個資料夾。

Step 2：理解目錄結構

Tolaria 的知識庫就是一個普通的資料夾，典型結構如下：

my-vault/
├── .git/                  # Git 儲存庫（自動產生）
├── AGENTS.md              # AI 助手設定檔案
├── types/                 # 類型定義資料夾
│   ├── note.type.yaml     # 筆記類型範本
│   └── task.type.yaml     # 任務類型範本
├── inbox/                 # 收件匣（快速擷取想法）
├── projects/              # 專案筆記
├── areas/                 # 責任領域
├── resources/             # 參考資料
└── archive/               # 封存內容

提示：這種結構參考了 PARA 方法（Projects, Areas, Resources, Archive），但你完全可以自訂。

Step 3：建立第一條筆記

在 Tolaria 中按 Cmd/Ctrl + N 建立新筆記：

---
title: Tolaria 學習筆記
type: note
created: 2026-06-10
tags:
  - tolaria
  - knowledge-base
---

# Tolaria 核心功能

Tolaria 是一個...

## 關鍵特性

- 檔案優先
- Git 優先
- 離線優先

## 相關連結

- [[另一條筆記]]  <!-- 雙向連結 -->
- [Tolaria GitHub](https://github.com/refactoringhq/tolaria)

Step 4：設定 Git 遠端儲存庫（可選但推薦）

# 在 vault 目錄下執行
cd ~/my-knowledge-base

# 新增遠端儲存庫（GitHub/GitLab/Gitee）
git remote add origin https://github.com/yourusername/my-vault.git

# 推送
git push -u origin main

這樣你的筆記就有了雲端備份，並且可以在多裝置間同步。

---

核心功能詳解

1. 檔案優先：純 Markdown 的力量

Tolaria 最大的優勢是不創造專有格式。你的每條筆記都是標準的 Markdown 檔案：

# 在任何編輯器中開啟
code ~/my-vault/inbox/idea.md
vim ~/my-vault/projects/project-a.md

# 用 grep 搜尋
grep -r "關鍵詞" ~/my-vault/

# 批次處理
find ~/my-vault -name "*.md" -exec sed -i 's/舊詞/新詞/g' {} \;

這意味著： - ✅ 可以用任何文字編輯器修改 - ✅ 可以用腳本批次處理 - ✅ 可以納入版本控制 - ✅ 可以與其他工具整合（如靜態網站產生器）

2. Git 整合：版本歷史的天然優勢

每次修改筆記後，Tolaria 會自動偵測變更並提示提交。你也可以手動操作：

# 檢視變更
git status
git diff

# 提交變更
git add .
git commit -m "更新專案筆記"

# 檢視歷史
git log --oneline

# 復原到某個版本
git checkout <commit-hash> -- filename.md

實戰場景：你在寫一篇文章，不小心刪掉了一段重要內容。透過 git log 找到之前的提交，用 git checkout 復原即可。

3. 雙向連結：建構知識網路

Tolaria 支援 Wiki-style 雙向連結：

# 在筆記 A 中
參見 [[筆記 B]] 瞭解更多。

# 在筆記 B 中
這是被 [[筆記 A]] 引用的內容。

在 Tolaria 介面中： - 點選連結直接跳轉 - 右鍵檢視「反向連結」（哪些筆記引用了目前筆記） - 圖形視圖展示筆記之間的關係網

4. 類型系統：靈活分類

Tolaria 的類型（Types）不是強制性的 schema，而是導航輔助：

# types/note.type.yaml
name: Note
icon: 📝
color: blue
fields:
  - name: created
    type: date
  - name: tags
    type: list

---
title: 我的筆記
type: note
created: 2026-06-10
tags:
  - learning
---

你可以在側邊欄按類型過濾筆記，但沒有必填欄位，也不會因為缺少欄位而報錯。

5. Command Palette：鍵盤高效操作

按 Cmd/Ctrl + P 開啟命令面板，類似 VS Code：

• Quick Open：快速開啟筆記
• Create Note：新建筆記
• Search：全文搜尋
• Git Commit：提交變更
• Toggle Theme：切換主題

常用快捷鍵： - Cmd/Ctrl + N：新建筆記 - Cmd/Ctrl + P：命令面板 - Cmd/Ctrl + F：搜尋 - Cmd/Ctrl + Shift + F：全域搜尋 - Cmd/Ctrl + [：返回上一頁

---

AI 整合：讓 AI 助手理解你的知識庫

Tolaria 的核心亮點之一是原生支援 AI 程式設計助手。每個 vault 根目錄都有一個 AGENTS.md 檔案，告訴 AI 如何理解你的知識庫結構。

設定 Claude Code

# 在 vault 目錄下
cd ~/my-vault

# 初始化 Claude Code（如果尚未安裝）
claude

# Claude Code 會自動讀取 AGENTS.md 瞭解你的筆記結構

AGENTS.md 範例內容：

# AGENTS.md - Tolaria Vault Guide

This vault uses the PARA method for organization:

- **Projects/**: Active projects with deadlines
- **Areas/**: Ongoing responsibilities
- **Resources/**: Reference materials
- **Archive/**: Completed or inactive items

## Note Format

All notes are Markdown files with YAML frontmatter:

```yaml
---
title: Note Title
type: note|task|resource
created: YYYY-MM-DD
tags: [tag1, tag2]
---

Common Tasks

• To find recent notes: search by created date in frontmatter
• To find related notes: look for [[wiki-links]]
• To update a project: check projects/ directory

### 實戰：用 AI 整理筆記

```bash
# 在 vault 目錄中執行 Claude Code
claude

# 然後提問：
# "幫我總結 projects/ 目錄下所有未完成的專案"
# "找出所有包含 'TODO' 的筆記"
# "為我的 Python 學習筆記新增標籤"

支援的其他 AI 工具

• Codex CLI：OpenAI 的命令列工具
• Gemini CLI：Google Gemini 的命令列介面
• 任意 LLM：因為筆記是純文字，你可以用任何 AI 工具處理

---

進階用法

1. Inbox 工作流程：快速擷取想法

Tolaria 推薦的工作流程是「Inbox → 整理」：

1. 擷取：有任何想法時，快速在 inbox/ 下建立筆記，不要糾結分類
2. 整理：每天/每週回顧 inbox，將筆記移動到合適的資料夾

# 範例：快速擷取
# 按 Cmd/Ctrl + N，輸入標題，儲存為 inbox/quick-thought.md

# 定期整理
mv inbox/quick-thought.md projects/project-alpha/
git add .
git commit -m "整理 inbox：移動筆記到專案"

2. Web 剪藏：儲存網頁內容

Tolaria 提供了瀏覽器擴充功能（或 Bookmarklet）來儲存網頁：

// Bookmarklet 程式碼（儲存到瀏覽器書籤）
javascript:(function(){
  const title = document.title;
  const url = window.location.href;
  const content = document.getSelection().toString() || document.body.innerText;

  const markdown = `---
title: ${title}
type: resource
created: ${new Date().toISOString().split('T')[0]}
source: ${url}
---

# ${title}

${content}
`;

  // 複製到剪貼簿，然後貼上到 Tolaria
  navigator.clipboard.writeText(markdown);
  alert('已複製到剪貼簿，請在 Tolaria 中貼上');
})();

3. 範本系統：標準化筆記格式

在 templates/ 目錄下建立範本：

# templates/meeting-note.md
---
title: {{title}}
type: meeting
created: {{date}}
attendees: []
---

# {{title}}

**日期：** {{date}}
**參與者：** 

## 議程

1. 
2. 

## 討論要點

## 行動項目

- [ ] 

然後在新建筆記時複製範本並替換變數。

4. 與靜態網站產生器整合

因為筆記是純 Markdown，你可以用 SSG 將知識庫發布為網站：

# 使用 MkDocs
pip install mkdocs
mkdocs new my-site
cp -r ~/my-vault/* my-site/docs/
mkdocs serve

# 或使用 Hugo
hugo new site my-blog
cp -r ~/my-vault/* my-blog/content/
hugo server

5. 多裝置同步

透過 Git 實現多裝置同步：

# 裝置 A（推送）
cd ~/my-vault
git add .
git commit -m "更新筆記"
git push

# 裝置 B（拉取）
cd ~/my-vault
git pull

提示：如果有衝突，Git 會提示你手動合併。對於 Markdown 檔案，合併通常很簡單。

---

常見問題

Q1: Tolaria 和 Obsidian 有什麼區別？

A: 主要區別在於設計理念： - Obsidian：功能豐富，有龐大的外掛生態，但核心是閉源的 - Tolaria：完全開源，Git 原生整合，AI 友好，更輕量

如果你重視資料主權和開源透明，Tolaria 是更好的選擇。如果你需要行動端 App 和豐富的社群外掛，Obsidian 可能更適合。

Q2: 我可以從 Obsidian 遷移到 Tolaria 嗎？

A: 可以！因為兩者都使用純 Markdown 檔案，只需：

# 複製 Obsidian vault 到 Tolaria
cp -r ~/obsidian-vault ~/tolaria-vault
cd ~/tolaria-vault
git init
git add .
git commit -m "從 Obsidian 遷移"

然後在 Tolaria 中開啟這個資料夾即可。雙向連結語法（[[link]]）也相容。

Q3: Tolaria 支援行動端嗎？

A: 目前 Tolaria 只有桌面端（macOS/Windows/Linux）。行動端可以透過以下方式存取： - 用 Git 同步後，在手機上的 Markdown 編輯器（如 iA Writer、1Writer）開啟 - 將 vault 發布為靜態網站，透過瀏覽器存取

Q4: 如何處理圖片附件？

A: 在 vault 中建立 assets/ 資料夾存放圖片：

![示意圖](assets/diagram.png)

# 複製圖片到 assets 目錄
cp ~/Downloads/diagram.png ~/my-vault/assets/
git add assets/diagram.png
git commit -m "新增示意圖"

Q5: Tolaria 的效能如何？能處理多少筆記？

A: Tolaria 的作者用它管理 10,000+ 條筆記，日常使用流暢。效能瓶頸通常在於： - Git 操作（大量檔案時 git status 會變慢） - 全文搜尋（可以透過索引優化）

建議定期封存舊筆記到 archive/ 目錄，保持活躍筆記數量在合理範圍。

---

總結

Tolaria 是一個為開發者設計的知識庫工具，它的核心價值在於：

1. 資料主權：純 Markdown 檔案，零鎖定
2. 版本控制：Git 原生整合，天然的歷史追蹤
3. AI 友好：原生支援主流 AI 程式設計助手
4. 開源免費：完全透明，無隱藏成本
5. 跨平台：macOS / Windows / Linux

適合人群： - ✅ 開發者、技術寫作者 - ✅ 重視資料主權的知識工作者 - ✅ 已經使用 Git 的團隊 - ✅ 想用 AI 輔助管理知識的使用者

不太適合： - ❌ 需要行動端 App 的使用者 - ❌ 喜歡富媒體嵌入（影片、互動式圖表）的使用者 - ❌ 不想折騰 Git 的非技術使用者

資源連結： - Tolaria GitHub 儲存庫 - 下載頁面 - 入門知識庫範本 - 作者 Luca 的 X 帳號

如果你覺得這篇文章有幫助，歡迎分享給更多開發者！