当所有编辑器都在争着把 AI 塞进你的文档，有没有人想过——AI 的修改，凭什么直接覆盖我写的字？
写作这件事，被 AI 搞复杂了
2024 年以来，AI 写作工具像雨后春笋一样冒出来。Notion AI、Cursor、各种 Copilot……每一个都在告诉你：「我来帮你写」。
但实际体验呢？
- 你写了一段文字，AI 自作主张帮你改了，你还没看清改了什么就已经生效了
- 你的文档存在云端，导出格式是私有的，换个工具就迁移不走
- 你想用本地模型？对不起，只支持官方指定的那几个 API
- 你只想写个 Markdown，结果得先注册账号、选订阅计划、配同步服务
写作这件最简单的事，被搞复杂了。
Markra 试图回到一个更朴素的问题：能不能有一个好用的 Markdown 编辑器，AI 是它的辅助，而不是它的主人？
GitHub：https://github.com/murongg/markra
Markra 是什么？
Markra 是一个本地优先的开源 Markdown 编辑器，把 AI 融入写作流程。
它有三个核心原则：
📁 本地优先
文件以纯 .md 格式保存在本地磁盘。无需云同步，无需注册账号。你的文档永远在你手里。
🤖 AI 原生，但你是主人
AI 可以帮你润色、改写、扩写、翻译——但所有修改都先预览，确认后才写入。AI 不会在你看不见的地方动你的文字。
🔓 完全开源，免费使用
核心功能可审计，永不设付费墙。AGPL-3.0 许可证。
核心特性
✍️ 所见即所得 + 源码模式
- 链接、图片、HTML、KaTeX 公式、Mermaid 图表、GFM 表格全部内联渲染
- 任何元素随时展开回源码
- 斜杠菜单和拖拽手柄进行块级编辑
- 一键切换完整源码模式
- 可调整正文宽度、字号和行高
🤖 AI 写作助手（内联 + 侧边栏）
- 内联 AI：选中文本，直接在原文位置触发 AI 编辑
- 侧边栏 AI：打开侧边栏处理整篇文档
- 内置快捷操作：润色、改写、续写、总结、翻译
- 每次 AI 修改都先预览——接受、拒绝或复制，由你决定
- 会话支持搜索、重命名和归档
🧩 多服务商支持
支持云端模型、本地模型和任意 OpenAI 兼容接口：
- 内置服务商：OpenAI · Anthropic · Google Gemini · DeepSeek · Mistral · Groq · OpenRouter · Together.ai · Qwen · Xiaomi MiMo · Volcengine Ark · xAI · Azure OpenAI · Ollama
- 内联编辑和侧边栏可分别选择不同模型
- 联网搜索：服务商原生搜索、Bing 和 SearXNG，结果数量和正文长度均可配置
📂 文件管理
- 打开单个文件或整个文件夹
- 文件树浏览、新建、重命名和删除
- 文档标签页、大纲导航和双链补全
- 粘贴图片可存到本地、S3 或 WebDAV
🎨 排版与导出
- GitHub 风格提示块（note、tip、important、warning、caution）
- 可视化表格控件，调整行列、尺寸和对齐
- 语法高亮代码块，支持语言选择和一键复制
- 内置主题或限定作用域的自定义 CSS，支持导入/导出/重置
- 导出为独立 HTML 或 PDF，完整控制页面、边距和元数据
竞品对比：Markra 到底好在哪？
市面上的 Markdown 编辑器 + AI 写作工具不少，我们挑几个有代表性的来对比。
对比总览
| 维度 | Markra | Typora | Notion | Obsidian | Cursor |
|---|---|---|---|---|---|
| 开源 | ✅ AGPL-3.0 | ❌ 闭源付费 | ❌ 闭源 | ✅ 部分开源 | ❌ 闭源 |
| 免费 | ✅ 完全免费 | ❌ 付费 ($14.99) | ⚠️ 免费有额度 | ✅ 核心免费 | ⚠️ 免费有额度 |
| 文件格式 | 纯 .md 本地 | 纯 .md 本地 | 私有云端格式 | 纯 .md 本地 | 项目文件 |
| AI 写作 | ✅ 原生集成 | ❌ 无 | ✅ Notion AI | ⚠️ 需插件 | ✅ 代码补全为主 |
| AI 修改预览 | ✅ 先预览再写入 | — | ❌ 直接生效 | ⚠️ 取决于插件 | ❌ 直接生效 |
| AI 服务商 | 15+ 可选 | — | 仅官方 | ⚠️ 取决于插件 | 仅官方 |
| 本地模型 | ✅ Ollama 等 | — | ❌ | ⚠️ 需配置 | ❌ |
| WYSIWYG | ✅ | ✅ | ✅ | ❌ Markdown 源码 | ❌ |
| 联网搜索 | ✅ 多引擎 | ❌ | ❌ | ⚠️ 需插件 | ✅ |
| 无需注册 | ✅ | ✅ | ❌ | ✅ | ❌ |
| 数据本地 | ✅ | ✅ | ❌ 云端 | ✅ | ✅ |
vs Typora：AI 时代的答案
Typora 是 WYSIWYG Markdown 编辑器的标杆。它的渲染效果和轻量体验至今无可挑剔——但它没有 AI。
在 2025 年，一个不支持 AI 的写作工具就像一个不支持拼写检查的 Word。不是不能写，但你得自己干所有脏活。
Markra 的定位很明确：Typora 的 WYSIWYG 体验 + 原生 AI 能力 + 开源免费。
如果你是 Typora 的老用户，Markra 的编辑体验会让你感到熟悉——所见即所得、块级编辑、一键切源码。区别在于，当你写完一段话觉得「措辞不够利落」，不用复制到 ChatGPT 再贴回来，选中文字，一个斜杠命令，AI 就在原文位置帮你润色，改完还能先看 diff 再决定接不接受。
vs Notion：数据主权之争
Notion 是最受欢迎的在线协作文档工具，AI 功能也很完善。但它有两个硬伤：
- 数据不在你手里。文档存在 Notion 服务器上，导出格式是私有 JSON，离了 Notion 就是个黑盒。你写的每一个字都寄人篱下。
- AI 只有官方选项。Notion AI 只能用 Notion 自己的模型，你没法换 DeepSeek、没法用本地 Ollama、没法接你公司的私有部署。
Markra 的回答是：文件就是 .md，在你自己的磁盘上，用任何编辑器都能打开。AI 请求只发往你指定的服务商，你可以今天用 GPT-4o，明天用 DeepSeek，后天用本地 Ollama——没人替你做选择。
vs Obsidian：给不想折腾的人
Obsidian 是本地优先 Markdown 编辑的标杆，插件生态极其丰富。但它的 AI 能力完全依赖第三方插件——你需要自己找插件、配 API Key、处理兼容性问题。而且 Obsidian 的核心编辑体验是纯 Markdown 源码模式，没有 WYSIWYG。
Obsidian 是给折腾党准备的。 你得花时间折腾插件、折腾主题、折腾同步方案。折腾好了很爽，折腾的过程很痛苦。
Markra 是给不想折腾的人准备的。AI 开箱即用，WYSIWYG 开箱即用，双链补全开箱即用。打开文件就能写，想用 AI 就配置一下 API Key，不想用就是个纯编辑器。写作优先，其他都靠后。
vs Cursor：不同的赛道
Cursor 是当前最火的 AI 代码编辑器，基于 VS Code。它的 AI 补全和 Agent 能力确实很强——但它是为写代码设计的。
用 Cursor 写 Markdown？可以，但你得到的是：
- 一个代码编辑器的 UI，不是写作工具的 UI
- AI 补全以代码逻辑为主，不是以写作逻辑为主
- 没有内联渲染，看不到排版效果
- 没有 WYSIWYG，纯源码模式
Cursor 是写代码用的。Markra 是写字用的。 赛道不同，别硬蹭。
Markra 的设计哲学
写作优先
AI、文件管理和设置都服务于文档，而不是反过来。
这句话是 Markra 的灵魂。太多工具把 AI 当主角，写作当配角——打开就是 AI 对话框，文档编辑功能反而是附赠的。Markra 反过来：你打开看到的是编辑器，AI 是你用斜杠命令召唤出来的助手。
确认后再应用
AI 修改是预览，由你决定是否写入。
这不是一个小功能点，而是一个立场。很多工具为了「流畅体验」，让 AI 的修改直接生效，撤销还得自己 Ctrl+Z。Markra 不这样：AI 的每一处修改，你都能先看清楚再决定。 接受、拒绝或复制，三选一，没有默认。
本地优先
文件和工作区数据留在你的磁盘上。
这不是「支持本地存储」，而是「默认就是本地」。不需要云同步、不需要注册账号、不需要担心服务商跑路。你的 .md 文件在哪个文件夹，就在哪个文件夹。用任何文本编辑器都能打开。
谁适合用 Markra？
📝 博客作者
写技术博客，需要代码高亮、表格、Mermaid 图表、KaTeX 公式——Markra 全部内联渲染。写完导出 HTML 直接发布，或导出 PDF 存档。
📚 研究者
研究笔记、文献摘要、思考框架——用双链补全把知识串起来，用 AI 帮你总结和翻译。文件就在本地，不担心数据泄露。
💻 技术写作者
技术文档、API 文档、README——GFM 表格、代码块、GitHub 风格提示块全都有。AI 帮你润色措辞，不碰代码逻辑。
🧠 个人知识管理者
打开一个文件夹就是知识库。文件树 + 大纲导航 + 双链补全，比 Obsidian 轻量，比 Notion 自由。
🔒 隐私敏感用户
AI 请求只发往你指定的服务商。用本地 Ollama？完全可以，一行流量都不出你的机器。
快速开始
- 从 GitHub Releases 下载适合你平台的版本：
- macOS：Apple Silicon / Intel
- Windows：安装包 / 便携包
- Linux：AppImage
- 打开一个 Markdown 文件或文件夹
- 开始写作——所见即所得、斜杠菜单或源码模式均可
- 准备好使用 AI 时，在设置里配置服务商和模型即可
未来路线
Markra 的路线图聚焦于四个方向：
- 更稳定的工作区行为和边界情况处理——先把基础打牢
- 更智能的 AI 编辑预览和冲突解决——AI 改了又改怎么办？冲突怎么解决？
- 全文搜索和知识整理——让本地知识库更可用
- 更丰富的导出模板和分享流程——写完了，怎么发出去？
开源协议
AGPL-3.0
这意味着你可以自由使用、修改和分发，但如果你在网络服务中使用修改后的代码，也需要开源。这是对开源生态的保护，也是对商业闭源套壳的防御。
结语
Markra 不是要取代 Typora、Notion 或 Obsidian。
它是在回答一个被忽视的问题：在 AI 时代，写作工具应该是什么样子？
不是把 AI 对话框塞进编辑器，不是让 AI 直接改你的字，不是把你的文档锁在云端。
而是：你写你的，AI 辅助你；你说了算，AI 只是建议；文件在你手里，AI 请求由你指路。
如果你厌倦了 AI 替你做决定，厌倦了数据被锁在云端，厌倦了为基本功能付费——试试 Markra。
写作优先，AI 靠后。
这才是一个写作工具该有的样子。
项目地址：https://github.com/murongg/markra
「AI 应该是你的笔，不是你的作者。」
相关文章
