🧠 OpenKnowledge：AI驱动的Markdown知识库编辑器适用于、LLM wiki和笔记

OpenKnowledge 是开源 AI Markdown 知识库编辑器，集成 Claude/Codex/Cursor 等编程工具，支持 WYSIWYG 编辑、本地知识库管理与团队协作。macOS/Linux/Windows 全平台免费，Notion+VSCode 的完美开源平替。

🎤 引言

你是否遇到过这种场景：Notion 笔记积压成山却因为网络问题打不开？Obsidian 写作够轻量但和 Claude/Codex 协作总要多走一步？VSCode 写 Markdown 体验生硬？

OpenKnowledge 就是为解决这些痛点而生的——Notion 体验 + VSCode 灵活 + Claude 协作 三合一，本地优先、隐私可控、完全免费。这是由 inkeep 团队开源的 AI 驱动 Markdown 知识库编辑器，在 GitHub 上已经收获 1.7k+ Star，定位直指"Notion 的开源替代"。

⭐ 核心功能

真正的 WYSIWYG 编辑体验：编辑 Markdown 文件像编辑 Google Doc 或 Notion 页面一样，所见即所得。没有双栏预览的割裂感，光标在哪里渲染就在哪里，复杂的嵌套列表、表格、公式都能优雅处理。

AI 协作深度集成：开箱即用集成 Claude、Codex、Cursor 等主流 AI 编程工具，通过 MCP（Model Context Protocol）协议实现 skill 传递和 agentic search。任何支持 MCP/CLI 的 harness 都能接入，比如 OpenCode。

本地优先 + 隐私可控：所有数据存储在本地文件夹，AI 调用走用户自己的 API Key，没有云端锁定。知识库本质就是一堆 .md/.mdx 文件，可用 Git/GitHub 同步，支持团队 Auto-sync 协作。

多功能界面：

桌面端：原生 macOS 应用，自带 TUI 终端界面
Web 端：跨平台 Web UI（Linux/Windows/Intel Mac 通过 CLI 启动）
内嵌 HTML 组件：写工程规格、可视化报告时直接嵌入富组件
知识图谱：自动生成双向 wiki 链接，支持图谱视图

智能开箱即用：检测到 Claude Code、Cursor、Codex 等 agent harness 后，自动初始化 MCP 和 skill 配置，新人 5 分钟就能跑起来。

📥 安装使用

macOS 用户：直接下载桌面 App，点此下载最新版本，拖入 Applications 即可。

Linux / Windows / Intel Mac 用户：通过 npm 全局安装（需要 Node.js 24+）：

npm install -g @inkeep/open-knowledge
cd your-project
ok init          # 脚手架初始化，自动配置 Claude Code/Cursor/Codex
ok start --open  # 启动 Web 编辑器并在浏览器中打开

基础使用流程：打开本地任意包含 .md/.mdx 文件的文件夹（现有代码库、Wiki、Obsidian vault 都可以），编辑器会扫描文件结构并自动建立索引。也可以从官方 starter pack 一键创建 LLM Wiki 模板。

# 用 starter pack 创建新项目
ok init --template llm-wiki
ok start

配合 AI 工具：在编辑器中选中段落 → 唤起 AI → Claude/Codex 会基于当前文件上下文给出建议。整个流程无需复制粘贴，AI 看到的就是你看到的。

🎯 适用场景

个人知识库管理：技术博客作者、研究者、终身学习者，想要长期积累结构化笔记，又不想被 Notion 锁定数据。

AI 编程协作：Claude Code、Cursor、Codex 重度用户，希望 AI 理解整个项目的文档结构，给出更精准的代码建议。

团队 Wiki 协作：小团队用 Git/GitHub 做团队知识共享，想要 Notion 的协作体验但不想付费，且数据要掌握在自己手里。

LLM 知识库构建：开发者想给 AI Agent 喂一个干净的本地知识库（避免隐私数据外传），用 OpenKnowledge 的 MCP 能力直接对接任何 LLM harness。

产品规格 / 工程文档：需要写带可嵌入组件的可视化报告，OpenKnowledge 的 HTML embed 功能比传统 Markdown 灵活得多。

🔍 对比/替代方案

工具	定位	优势	短板
OpenKnowledge	AI 协作 + 本地知识库	MCP 原生、AI 深度集成、Notion 体验	仍在活跃开发、生态较新
Obsidian	纯本地 Markdown	插件生态成熟、双向链接强	无 AI 协作原生支持
Notion	云端协作	体验最佳、团队功能完整	数据云端锁定、付费
Cursor	AI 代码编辑器	AI 编程体验一流	偏代码编辑器而非知识库
Typora	WYSIWYG Markdown	极简干净	无 AI 集成、无协作
MarkText	开源 WYSIWYG	跨平台免费	维护放缓、无 AI 能力

简单说：想要 Notion 体验 + 本地化 + AI 协作 三者兼顾，OpenKnowledge 是目前开源界少有的选择。如果你只用本地笔记，Obsidian 仍然更成熟；如果你只写代码，Cursor 体验更好。

⚠️ 注意事项

1. Node.js 版本要求：CLI 模式需要 Node.js 24+，老版本会启动失败。建议用 nvm 管理 Node 版本。

2. 仍在快速迭代：项目采用 monorepo 结构（用 bun 管理），更新频繁。建议固定版本或关注 Releases 而不是 main 分支。

3. 许可证 GPL-3.0-or-later：Copyleft 许可证，二次分发需开源。对个人使用和大部分团队没问题，商业产品集成需要评估。

4. macOS 优先体验：原生 App 只支持 macOS，Linux/Windows 用户用 Web 模式（功能完整但少了 TUI 体验）。

5. AI 调用需自备 Key：所有 AI 功能调用的是用户自己的 Claude/Codex/Cursor 订阅，没有内置免费额度。

6. 项目指标（2026-07-01）：GitHub 1.7k Star / 81 Fork / 829 commits，10 个 open issues，活跃但不算头部项目，使用前最好评估下长期维护风险。

✅ 总结

OpenKnowledge 适合追求 Notion 体验又要数据自主、同时深度使用 AI 编程工具的用户。它把"本地优先 + AI 原生 + 开源免费"这三个看起来理所当然却很少有人同时做到的事情，做了出来。

优点非常明显：WYSIWYG 真顺手、AI 协作真深度、本地存储真安心。短板也很真实：项目还在快速变化、生态还不够大、macOS 以外体验有差距。

如果你的工作流是"在本地写大量 Markdown 文档 + 用 Claude/Codex 做 AI 协作"，强烈建议试试。如果你只是要一个 Markdown 编辑器，老牌工具可能更稳。

推荐指数：⭐⭐⭐⭐（4/5，给新项目一点成长空间）

📎 相关链接：