大家好，之前我在 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 版地址：
所见即所得 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 版：
GitHub：
https://github.com/markrahq/markra
下载地址：
https://github.com/markrahq/markra/releases
继续求 issue 、求建议、求真实吐槽。
尤其想听这些反馈：
- macOS 签名后的安装体验是否正常
- Web 版打开本地文件 / 文件夹是否符合直觉
- 所见即所得编辑还有哪些 Markdown 场景不舒服
- AI 功能应该更偏写作助手，还是更偏文档 agent
- WebDAV / 图片存储 / 导出这些功能是否够顺手
- Markra 后面应该继续保持轻量，还是逐渐做成完整 Markdown 工作台
感谢之前两次帖子里所有试用、提 bug 、提建议的朋友。Markra 1.0.0 算是一个阶段性节点，但肯定不是终点。后面会继续慢慢打磨。
1
Select Language