3.9K Star！Inkeep 把 AI 原生 Markdown 编辑器做成了开源项目！

Markdown 文件到底怎么写才舒服？

Inkeep 团队给出了答案，他们开源了OpenKnowledge。

一个真正为 AI 设计的知识库工具。

目前已经收获了 3.9K Star！

核心亮点

1、真正的所见即所得

这是 OpenKnowledge 最直观的体验提升。你在里面写文档，看到的就是最终成品——和 Notion 页面、Google Doc 一模一样。

但底层落盘的始终是纯文本 Markdown 文件，和你用 VS Code、Obsidian 打开没有任何区别。

这个体验的秘密是一个基于 yjs 的 CRDT 双重观察者架构。编辑器里同时跑着两个独立的 observer，一个盯着 ProseMirror（富文本编辑层），一个盯着原始 Markdown 文件，任何一侧发生变化，另一侧都会通过 delta transformation 无损同步。

2、AI 协作

打开 OpenKnowledge 侧边栏，你能直接拉起 Claude Code、Codex、Cursor、OpenCode、Pi 等多个 AI 编辑器，并排一起改同一份稿子。

不是”复制粘贴到对话框、粘回来”那套老办法，是真·实时协作——你改一段，AI 改另一段，两边的改动自动合并。

更狠的是那个 ok init 命令。

在你的项目目录里跑一次，它会自动检测你电脑上装了哪些 AI agent harness，然后一键配置好对应的 MCP server、agent skills 清单、索引策略。

3、Agentic Search

普通全文搜索是给人用的，Agentic Search 是给 AI 用的。这是 OpenKnowledge 和其他 Markdown 编辑器拉开差距的关键一层。

它不只是简单的关键词匹配，而是做了三件事：

• • 双路召回：向量索引 + 关键词索引同时工作，用的是开源 TypeScript 搜索引擎 Orama，不需要外部依赖
• • 智能分块：按 Markdown 标题层级（H1/H2/H3）自动切分 chunk，不用自己写 splitter
• • 跨文件链接：自动识别 [[wiki link]]、相对路径引用、GitHub-style 引用三种格式的链接关系

4、Git 做同步后端

README 里写了一句”No-code Team Sharing and Auto-sync powered by git/GitHub under the hood”——这句话的分量比看起来要重得多。

意思是：团队共享一个知识库 = 共享一个 GitHub repo（Private 或 Public 都行）。多人编辑 = Git 提交 + 自动冲突解决。

点一个按钮就能创建共享链接，背后做的事情是 git remote add + 推送。

这个设计的好处太明显了：

• • 没有服务器依赖：不需要自己搭同步服务，也不依赖任何第三方后端
• • 没有 vendor lock-in：哪天 OpenKnowledge 项目不维护了，你的 vault 仍然是普通 Markdown 文件 + 普通 Git 仓库，随便换 Obsidian、VS Code 都能接着用
• • 完整的版本控制：Git 的历史、branches、pull request 全部天然可用，团队协作流直接搬过来就行

快速上手

方式一：桌面版（推荐普通用户）

打开官网 openknowledge.ai/download 下载对应系统的安装包：

• • macOS（Apple Silicon）：下载 DMG，拖进 Applications 文件夹
• • Windows 10+（x64 / Arm64）：运行 Setup 安装器，用户级安装，不需要管理员权限

安装完首次打开，会弹出一个对话框询问是否连接 AI 工具，确认后它会自动检测你电脑上的 Claude Code、Cursor、Codex 等，完成配置。

然后在启动器里点”Create new project”，或者选一个 starter pack，填个项目名就能开始用了。

方式二：Web/CLI 版

需要 Node.js 24+ 和 git 环境：

# 全局安装
npm install -g @inkeep/open-knowledge
# 进入你的 Markdown 项目目录cd your-project
# 一键初始化：检测 AI agent、配置 MCP、建立索引ok init
# 启动本地 Web 编辑器，自动打开浏览器ok start --open

ok init 这个命令是核心——它会扫描你的系统，找到已安装的 AI 工具，然后自动写好配置文件。

如果你没装任何 AI 工具也没关系，它会跳过 AI 配置部分，纯当 WYSIWYG Markdown 编辑器用也完全可以。

配置团队共享

如果你想和同事一起用，最简单的方式：

# 在项目目录里
git init
git remote add origin git@github.com:your-org/your-vault.git
git add . && git commit -m "init" && git push

然后让同事 clone 这个仓库，在本地跑 ok init + ok start，就可以了。OpenKnowledge 会自动识别这是个 Git 仓库，提供一键同步按钮。

写在最后

2026 年了，”本地优先（Local First）”这个词被说烂了。但 OpenKnowledge 让我觉得，它重新定义了这四个字的内涵。

以前说”本地优先”，指的是”数据不离开我的硬盘”。

现在加上 AI agent harness，它变成了：AI 可以读我的本地知识库，但知识库本身不离开我的硬盘。

这对于处理敏感文档、内部技术规范、私有架构设计的团队来说，是一个完全不同的安全边界。

如果你一直在 Markdown 工具之间来回横跳，或者想试试让 AI agent 真的”理解”你的知识库，这个项目值得关注一波。

GitHub：github.com/inkeep/open-knowledge