Markra 1.0.0 发布了：一个开源、本地优先、原生支持 AI 的所见即所得 Markdown 编辑器

大家好，之前我在 V2EX 发过两次 Markra 。

第一次是桌面版刚做出来的时候：一个 AI Native 、极简、所见即所得的 Markdown 编辑器。

第二次是 Web 版上线：把核心编辑能力抽出来，让 Markra 在浏览器里也能用。

这次想同步一个更正式的节点：Markra 1.0.0 发布了。

Markra 是一个本地优先的开源 Markdown 编辑器，目标是把 AI 融入真实写作流程里，而不是在编辑器旁边硬塞一个聊天框。它支持所见即所得和源码两种模式，文件依然是普通 .md 文件，默认保存在本地磁盘。AI 可以帮你润色、改写、续写、总结或翻译，但所有修改都会先预览，确认后才会写入。

从 5 月 11 日第一个版本到现在，Markra 已经发了 144 个 release 。根据我自己的 GitHub release dashboard ，截至 2026-07-01 20:01：

• GitHub star：508


• fork：23


• 总下载量：19,470


• 安装包下载：5,868


• 自动更新请求：13,511


• 预估活跃用户：约 362


• 预估总用户：约 3,500


• 平台下载分布：Windows 77.1%，macOS 11.7%，Linux 11.2%

这些数字不算大，但对一个从 V2EX 反馈帖里慢慢打磨出来的开源小项目来说，已经让我很意外了。

这次 1.0.0 版本，Markra 现在主要支持这些能力：

桌面版和 Web 版

Markra 现在有桌面版和 Web 版。

桌面版支持 macOS Apple Silicon / Intel 、Windows 安装包 / 便携包和 Linux AppImage 。Web 版可以直接在浏览器里使用。

桌面版可以通过原生文件对话框打开本地文件和文件夹，支持真实文件路径、文件监听、自动保存、标签页恢复和工作区状态恢复。Web 版则基于浏览器文件选择、文件夹选择和文件句柄能力运行，在浏览器权限允许时也可以做文件树操作。

Web 版地址：

https://editor.markra.app/

所见即所得 Markdown

Markra 支持所见即所得编辑，也可以一键切换完整源码模式。

目前支持内联渲染：

• 链接


• 图片


• HTML


• KaTeX 公式


• Mermaid 图表


• GFM 表格

这些元素在需要时也可以展开回源码。编辑器里还支持斜杠菜单、块级拖拽手柄、正文宽度调整、字号和行高调整。

桌面版还做了自己的本地拼写检查，不依赖系统或 Electron 默认拼写检查。语言包按需下载，也支持个人白名单。

本地工作区

Markra 可以打开单个 Markdown 文件，也可以打开整个文件夹作为工作区。

现在支持：

• 文件树浏览


• 新建、重命名、移动、删除文件


• 文件排序、定位、多选


• 文档标签页


• 分屏窗格


• 快速打开


• 工作区搜索


• 大纲导航


• 双链补全


• 文档字数和选中文本字数统计

这一块主要是为了让 Markra 不只是一个单文件编辑器，而是可以真正管理一组本地 Markdown 文档。

原生 AI

Markra 的 AI 能力主要分两种。

一种是选中文本后直接使用内联 AI ，比如润色、改写、续写、总结、翻译。

另一种是打开 AI 侧边栏，对整篇文档做更长的任务。

所有 AI 修改都会先展示预览，你可以接受、拒绝或复制，不会直接覆盖正文。

目前还支持 Agent Client Protocol （ ACP ），可以连接兼容的本地 AI Agent ，支持模型发现、权限确认和编辑器写入预览。AI 会话也支持搜索、重命名和归档。

内置服务商包括：

OpenAI 、Anthropic 、Google Gemini 、DeepSeek 、Mistral 、Groq 、OpenRouter 、Together.ai 、Qwen 、Xiaomi MiMo 、Volcengine Ark 、xAI 、Azure OpenAI 、Ollama 。

也支持任意 OpenAI 兼容接口。内联编辑和侧边栏可以分别选择模型。

联网搜索方面，支持服务商原生搜索、Bing 和 SearXNG ，并且可以配置搜索结果数量和正文长度限制。

图片存储、备份和同步

这块是之前 V2EX 里很多朋友提到的需求，现在已经做进去了。

桌面版支持把粘贴或拖入的图片保存到：

• 本地文件夹


• WebDAV


• PicGo / PicList


• S3 兼容对象存储

Web 版支持本地 / 浏览器文件句柄，以及在 CORS 允许时使用 WebDAV 。

桌面版还支持本地单向备份，可以手动备份、退出时备份或定时备份。WebDAV 同步也已经支持，用来让多设备笔记保持一致，并保留冲突副本。

表格、代码和提示块

Markra 支持 GitHub 风格提示块：

• note


• tip


• important


• warning


• caution

表格支持可视化控制，可以调整行列、尺寸和对齐。

代码块支持语法高亮、语言选择和一键复制。

主题和导出

Markra 支持内置主题，也支持限定作用域的自定义 CSS ，并且可以导入、导出和重置。

导出方面，桌面版支持导出为 HTML 、PDF ，以及配置 Pandoc 后的更多格式。Web 版支持 HTML 下载和浏览器打印 / PDF 。

本地优先和开源免费

Markra 不需要注册账号。

文件默认留在本地磁盘。只有当你主动配置 WebDAV 同步、远程图片存储、AI 服务商或 Web 搜索时，才会访问对应服务。

项目是 AGPL-3.0 开源，核心功能免费使用。

这次 1.0.0 还有一个对 macOS 用户比较重要的变化：macOS 版本已经接入 Developer ID 签名和 Apple 公证。

之前因为没签名，macOS 用户下载后需要绕系统限制，体验很不好。现在 GitHub Actions 里的 macOS 构建已经能自动签名、公证并发布，后续安装会正常很多。

我不太想把 Markra 做成一个特别重的 Markdown 工作台。更理想的方向还是：

写作时足够轻，管理文件时不添乱，Markdown 文件仍然可迁移，AI 能参与写作但不打断写作。

适合的场景大概是：

• 产品文档


• 博客长文


• 研究笔记


• 技术写作


• 表格、代码、公式混排文档


• AI 辅助起草和润色


• 个人知识库

如果你之前用 Typora 、Obsidian 、Joplin 、VSCode 写 Markdown ，或者现在已经进入“AI 先写，我再改”的写作方式，可以试试看 Markra 现在这个版本。

Web 版：

https://editor.markra.app/

GitHub：

https://github.com/markrahq/markra

下载地址：

https://github.com/markrahq/markra/releases

继续求 issue 、求建议、求真实吐槽。

尤其想听这些反馈：

1. macOS 签名后的安装体验是否正常


2. Web 版打开本地文件 / 文件夹是否符合直觉


3. 所见即所得编辑还有哪些 Markdown 场景不舒服


4. AI 功能应该更偏写作助手，还是更偏文档 agent


5. WebDAV / 图片存储 / 导出这些功能是否够顺手


6. Markra 后面应该继续保持轻量，还是逐渐做成完整 Markdown 工作台

感谢之前两次帖子里所有试用、提 bug 、提建议的朋友。Markra 1.0.0 算是一个阶段性节点，但肯定不是终点。后面会继续慢慢打磨。