OpenKnowledge：開源 AI 原生筆記軟體，Notion 和 Obsidian 的終極替代？

前言

最近 AI 工具圈有一個新東西竄出來，讓不少用 Obsidian 和 Notion 的人開始動搖了——OpenKnowledge。

簡單說，這是一個開源的、本地優先（Local-First）的 Markdown 編輯器，但它不只是「又一個筆記軟體」。它的核心定位是：讓 AI 代理（Agent）和人類共同維護一個知識庫。

你沒聽錯，AI 不只是「幫你寫筆記」，而是可以直接在你的筆記裡讀寫、搜索、管理知識。

這篇文章我會把 OpenKnowledge 的來龍去脈、核心功能、安裝方式和使用方法整理得明明白白，讓你想深入了解或上手試試的時候，不用再去翻一堆零散的文件。

它到底是什麼？

OpenKnowledge 是由 Inkeep 團隊開發的開源專案，採用 GPL-3.0 授權。它的官網是 openknowledge.ai ，原始碼在 github.com/inkeep/open-knowledge 。

團隊自己的說法是：

「我們想打造一個像 Google Docs 一樣的編輯體驗，但底層全是乾淨的 Markdown 檔案。」

換句話說，它解決了一個長期存在的痛點：Markdown 編輯器的「寫的時候」和「看的時候」總是兩張臉。Obsidian 寫的時候是一堆符號，切換到預覽模式又是另一副模樣，那種割裂感就像戴著游泳鏡吃飯。

OpenKnowledge 用 WYSIWYG（所见即所得）的方式，讓你在編輯時就能看到最終效果，同時底層仍然是標準的 Markdown 檔案。

核心功能大解構

1. WYSIWYG Markdown 編輯器

這是最直觀的功能。OpenKnowledge 的編輯器基於 Tiptap / ProseMirror 這個強大的編輯引擎，搭配 CodeMirror 處理程式碼區塊，提供類似 Google Docs 的編輯體驗。

支援的進階 Markdown 元素包括：

• Callouts & Tips：內嵌的警告或提示框
• Accordions：可摺疊的段落
• Tabs：內嵌的內容切換標籤
• Mermaid：原生渲染流程圖和圖表
• Media：拖放圖片（支援縮放）和嵌入影片
• Embeddable HTML：支援互動式應用程式和數據視覺化

2. AI 原生整合（這才是重頭戲）

OpenKnowledge 不是一個「加了 AI 外掛」的筆記軟體，它是從設計之初就為 AI 打造的。

內建的 AI 代理整合：

• Claude（Anthropic）
• Codex（OpenAI）
• Cursor

這三個是目前最主流的 AI 程式設計代理，OpenKnowledge 讓它們可以直接在你的知識庫裡讀寫。

MCP（Model Context Protocol）整合：

MCP 是 AI 代理和外部工具之間的標準通訊協議。OpenKnowledge 內建了 MCP Server，讓 AI 代理可以直接呼叫它的工具（如 open-knowledge:write、open-knowledge:read 等），不需要手動複製貼上。

RAG（檢索增強生成）：

OpenKnowledge 內建了 RAG 能力，可以作為 AI 的「第二個大腦」。你可以把程式碼庫、技術文件、Slack 聊天記錄等資料接進來，讓 AI 進行統一的知識檢索。

Agentic Workflow（代理工作流）範例：

AI Agent: "I'll capture this as a decision doc.
Used open-knowledge:write. Calling 200 ok.
docName: decisions/api-strategy.
position: replace.
summary: Capture API choice decision."

看到沒？AI 可以直接在知識庫裡建立文件、更新內容，而你即時在編輯器裡看到它的工作成果。

3. CRDT 即時協作 + Git 版本控制

OpenKnowledge 使用 yjs（CRDT） 來處理多人即時協作。

什麼是 CRDT？簡單說就是讓多人同時改同一個文件而不打架的資料結構。Git 是改完再合併，CRDT 是你改你的我改我的，後台自動幫對齊，不用手工解衝突。

同時，所有變更都透過 Git 追蹤，提供完整的版本歷史、所有權和審計能力。分享和雲端同步功能表面上看是「無程式碼」操作，底層全是 Git 和 GitHub 在跑。

4. 與 Obsidian / Notion 的相容性

• Obsidian：高度相容。因為 Obsidian 用 Markdown，你可以直接把 Obsidian 的 vault 資料夾拖進 OpenKnowledge 使用。它支援大部分 Obsidian 特有的語法，包括 wikilinks。
• Notion：官方沒有做一鍵遷移工具，但你可以用 Notion 的「匯出為 Markdown」功能把內容弄出來。

5. Open Knowledge Format（OKF）

OpenKnowledge 採用了一套稱為 Open Knowledge Format（OKF） 的知識庫格式。這是由 Google 在 2026 年 6 月提出的開放標準，本質上是一個規範化的 Markdown 目錄結構：

---
type: BigQuery Table
title: Customer Orders
description: One row per completed order
resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders
tags: [sales, orders, revenue]
timestamp: 2026-05-28T14:30:00Z
---

# Customer Orders

Here's the schema for the customer orders table...

每個文件代表一個「概念」，包含 YAML frontmatter（結構化元資料）和 Markdown 主體（自由格式內容）。目錄裡還可以放 index.md（目錄頁）和 log.md（更新日誌）。

這套格式的妙處在於：AI 代理和人類可以用同一套格式讀寫知識庫，不需要額外的 API 或 SDK。

安裝與使用

環境需求

• Node.js 24+（如果使用版本管理器如 fnm、volta、mise，請鎖定 Node 24 以避免安裝時的版本檢查失敗）
• Bun 1.3.13+（僅開發者需要）
• Git

macOS 桌面版

1. 到 GitHub Releases 下載最新版的 .dmg
2. 打開 DMG，把 Open Knowledge 拖到 Applications 資料夾
3. 啟動應用程式

Linux / Intel Mac（CLI 模式）

這是大部分用戶會用到的方式：

# 1. 安裝 CLI（會把 ok 命令加入 PATH）
npm install -g @inkeep/open-knowledge

# 2. 建立或進入一個專案資料夾
mkdir my-knowledge-base && cd my-knowledge-base

# 3. 初始化知識庫
# ok init 會建立 .ok/ 目錄，並自動偵測和設定 Claude Code、Cursor、Codex 和 OpenCode
ok init

# 4. 啟動編輯器並打開瀏覽器
ok start --open

啟動後的工作流程

1. 初始化完成後，編輯器會顯示一個「你想建立什麼？」的輸入框
2. 輸入你想建立的主題，例如「我的 API 設計文檔」
3. 點擊 Create with Claude（旁邊的倒三角可以選擇 Codex、Cursor 或 CLI）
4. AI 代理會在嵌入的瀏覽器中打開 OpenKnowledge 編輯器，開始自動建立內容
5. 你可以在編輯器右上角看到 AI 代理的圖示，點擊它可以看到代理在所有文件中的活動記錄

在編輯器中與 AI 互動：

• 在編輯器底部的 Ask AI 欄位輸入問題
• 或在側邊欄的資料夾/文件上右鍵，選擇 Open with AI ▸ 選擇代理

桌面版的額外交互

桌面版還提供以下功能：

• 側邊欄：顯示知識庫中所有文件和資料夾
• 右側面板：查看文件的連結圖和時間線
• 右鍵選單：建立、顯示、重新命名、隱藏、刪除（移到垃圾桶）和 Open with AI
• 嵌入終端機：適合喜歡 TUI 的使用者

技術架構一覽

如果你對背後的技術棧感興趣：

專案採用 Bun workspaces + Turbo 進行建構，是一個典型的 monorepo 結構。

實際使用場景

場景一：工程師的技術規格文件

你和 AI 程式設計代理一起撰寫 RFC、runbook 和技術規格。代理可以直接在知識庫裡更新文件，你即時在編輯器裡看到變更。所有內容透過 Git 追蹤版本，和程式碼庫同步管理。

場景二：AI 代理的持久記憶

OpenKnowledge 可以作為 AI 代理的「持久記憶層」。代理在執行任務時，可以把決策、上下文和結果寫入知識庫；下次啟動時，代理可以從知識庫中讀取歷史記錄，保持任務的連續性。

場景三：團隊 Wiki

一個活生生的文件空間，存放筆記、決策和路線圖。透過團隊成員和 AI 代理的雙重貢獻，保持內容始終最新。

場景四：個人知識管理

把 Obsidian vault 直接搬過來用，享受 WYSIWYG 編輯體驗，同時讓 AI 幫你整理、連結和補充知識。

與現有工具的比較

小結

OpenKnowledge 目前還是一個相當新的專案（2026 年 6 月剛開源），但它踩在幾個正確的方向上：

1. AI 原生設計：不是事後加 AI，而是從第一天就為 AI 代理設計
2. 本地優先 + 開源：你的資料是你的，原始碼公開可審計
3. 標準化格式：OKF 讓知識庫可以被不同工具共用
4. 良好的相容性：Obsidian vault 可以直接搬過來用

如果你是一個經常和 AI 代理互動的開發者，或者受夠了 Obsidian 的編輯割裂感，OpenKnowledge 值得你花五分鐘試試。

畢竟，一個讓 AI 和人類共同撰寫知識庫的工具，可能是未來知識管理的標準模式。

相關連結：

• OpenKnowledge 官網
• GitHub 原始碼
• 快速入門文件
• Open Knowledge Format (OKF) 規格