之前我在少数派写过一篇文章，讲的是「Typora 收费之后，我给自己写了个 Markdown 编辑器」。那时候 Markra 还很早期，更多像是一个能跑起来、能日常写东西的 MVP。
当时我的想法很简单：我想要一个轻量、所见即所得、本地优先的 Markdown 编辑器，而且从一开始就应该把 AI 放进写作流程里。
现在过了一段时间，Markra 终于发到了 1.0.0。
这不是说它已经完美，也不是说以后不会继续大改。对我来说，1.0.0 更像是一个阶段性节点：核心写作、文件管理、AI 编辑、图片存储、备份同步、导出和跨平台发布这些基础能力已经完整跑通，可以更正式地推荐给别人试用了。
从一个自用工具到 1.0.0
Markra 最开始是我自己写给自己用的。
我之前一直用 Typora，所见即所得体验确实舒服。后来也试过 Obsidian、VS Code 加 Markdown 插件，以及一些带 AI 的编辑器。它们各自都很好，但总有一点不太对。
Obsidian 很强，但我不总是需要知识图谱、插件系统和一整套知识库工作台。
VS Code 适合写代码，但日常写文章、文档和笔记时，它还是太工程化。
很多 AI 写作工具则是另一种问题：AI 被放在旁边的聊天框里，写作和 AI 之间需要来回复制、改写、粘贴。真正进入正文的时候，反而被打断了。
所以我想做的是一个更安静的工具：文件还是普通 .md，编辑体验尽量接近文档，AI 可以参与写作，但不能抢走作者的控制权。
从 2026 年 5 月 11 日第一个版本到 2026 年 7 月 1 日，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%
这些数字不算大，但对一个从自用工具开始的小开源项目来说，已经让我很意外。更重要的是，很多功能和修复都来自真实用户反馈。
仍然是 Tauri，但桌面版更完整了
Markra 还是基于 Tauri 2。
我一开始选择 Tauri，是因为它可以用系统 WebView，不需要像 Electron 那样打包一整个浏览器。对一个 Markdown 编辑器来说，我希望它尽量轻，启动快，安装包也不要太大。
现在桌面版支持：
- macOS Apple Silicon / Intel
- Windows 安装包和便携包
- Linux AppImage
这次 1.0.0 里，对 macOS 用户比较重要的一点是：Markra 已经接入 Developer ID 签名和 Apple 公证。
之前 macOS 版本没有签名，用户下载之后需要绕过系统安全限制，安装体验很差。现在 GitHub Actions 的 macOS 构建会自动签名、公证并发布，正常下载安装就可以打开。
桌面版现在也更像一个完整应用，而不是一个简单编辑器壳子。它支持原生文件对话框、真实文件路径、文件监听、应用代理设置、本地备份、WebDAV 同步、图片上传和自动更新。
Web 版也能直接用
除了桌面版，Markra 现在也有 Web 版：
Web 版不是重新写的一套编辑器，而是复用了 Markra 的核心编辑能力。它同样支持所见即所得和源码编辑，可以通过浏览器文件选择、文件夹选择和文件句柄打开本地 Markdown。
当然，Web 版会受到浏览器权限和 CORS 限制。
桌面版可以访问真实文件路径、监听文件变化、做本地备份和 WebDAV 同步；Web 版则更适合临时打开、轻量编辑和无需下载安装的场景。
如果只是想快速试试 Markra，Web 版是最方便的入口。如果要长期管理本地 Markdown 工作区，桌面版还是更适合。
编辑体验：所见即所得，但不牺牲源码
Markra 的核心仍然是 Markdown 编辑。
它支持所见即所得，也支持一键切换完整源码模式。你可以像写普通文档一样写 Markdown，也可以在需要精确调整时回到源码。
目前编辑区支持内联渲染：
- 链接
- 图片
- HTML
- KaTeX 公式
- Mermaid 图表
- GFM 表格
这些元素不是不可编辑的最终态。需要修改时，可以展开回源码继续编辑。
输入体验上，Markra 支持斜杠菜单，可以快速插入标题、列表、引用、代码块、表格和 Callout。块元素有拖拽手柄，可以调整顺序。正文宽度、字号和行高也都可以调整。
表格不用手写 Markdown 语法，可以通过可视化控件调整行列、尺寸和对齐。代码块支持语法高亮、语言选择和一键复制。Callout 支持 GitHub 风格的 note、tip、important、warning 和 caution。
桌面版还内置了本地拼写检查。它不是直接依赖系统或 Electron 默认行为，而是由 Markra 自己维护本地词典。语言包按需下载，也支持把常用词加入个人白名单。
AI：预览后再应用
Markra 里的 AI 不是简单的聊天框。
我更希望它是一组编辑动作，发生在文本旁边，而不是把你从编辑器里拉出去。
现在主要有两个入口。
第一个是内联 AI。选中一段文字后，可以直接润色、改写、续写、总结、翻译，也可以输入自定义指令。
第二个是 AI 侧边栏。它适合处理整篇文档，比如整理结构、解释段落、查找内容或做更长上下文的编辑任务。
我比较坚持的一点是：AI 修改必须先预览。
每次 AI 给出的改动都会先展示出来，你可以接受、拒绝或复制。它不会直接覆盖正文。这样 AI 可以参与写作，但最后是否写入，仍然由作者决定。
Markra 现在内置支持这些服务商：
OpenAI、Anthropic、Google Gemini、DeepSeek、Mistral、Groq、OpenRouter、Together.ai、Qwen、Xiaomi MiMo、Volcengine Ark、xAI、Azure OpenAI、Ollama。
也可以接任意 OpenAI 兼容接口。内联编辑和侧边栏可以分别选择模型。
联网搜索方面，Markra 支持服务商原生搜索、Bing 和 SearXNG，结果数量和网页正文长度都可以配置。
另外，Markra 现在也支持 Agent Client Protocol（ACP）。如果你有兼容的本地 AI Agent，可以让 Markra 发现模型、请求权限，并在编辑器里预览写入结果。
AI 会话本身也支持搜索、重命名和归档，方便长期写作任务留下上下文。
工作区和文件管理
Markra 可以打开单个 Markdown 文件，也可以打开整个文件夹作为工作区。
文件树现在支持：
- 新建文件
- 重命名
- 移动
- 删除
- 排序
- 定位
- 多选
多文件可以用标签页打开，也可以用分屏窗格并排查看或编辑。Cmd/Ctrl+P 可以快速打开文件，工作区搜索可以在整个文件夹里查找内容。文档大纲可以用来快速跳转，双链补全则适合做简单的知识组织。
自动保存和状态恢复也做了。桌面版可以恢复已有文件、标签页、草稿和工作区窗口；Web 版则在浏览器文件句柄和 IndexedDB 可用时尽量恢复状态。
如果你只想写单篇文章，Markra 可以很轻。如果你有一整个 Markdown 文件夹，它也可以作为一个本地工作区来用。
图片、备份和同步
之前很多用户提到图片存储问题。
Markdown 文档里的图片如果处理不好，很容易变成迁移负担。存在编辑器内部不透明，手动上传又打断写作。
Markra 现在支持把粘贴或拖入的图片保存到：
- 本地文件夹
- WebDAV
- PicGo / PicList
- S3 兼容对象存储
比如你可以把图片放在文档旁边的本地 assets 目录，也可以上传到 NAS、对象存储，或者沿用已有的 PicGo / PicList 工作流。
桌面版还支持本地单向备份。可以手动备份，也可以设置退出时备份或定时备份。
如果需要多设备同步，Markra 支持 WebDAV 双向同步。发生冲突时会保留冲突副本，而不是直接覆盖掉某一边。
导出和主题
导出现在支持 HTML 和 PDF。
桌面版可以控制页面、边距和元数据。如果配置了 Pandoc，还可以导出更多格式。Web 版则支持 HTML 下载和浏览器打印 / PDF。
主题方面，Markra 有内置主题，也支持限定作用域的自定义 CSS。自定义 CSS 可以导入、导出和重置。
编辑器的写作宽度、字体大小、行高这些也都可以调。
几个设计决定
本地优先。 文件就是普通 .md，默认在你的磁盘上。你可以把文件夹放在 iCloud、OneDrive、坚果云、Git 仓库或 NAS 里，Markra 不绑定你到某个云端工作区。
不搞注册。 下载就能用。Web 版也不要求登录。
AI 由用户配置。 Markra 不强迫你使用某个内置账号或代理服务。AI 请求只发往你配置的服务商。
确认后再应用。 AI 修改是预览，不会直接写入正文。
开源免费。 Markra 使用 AGPL-3.0 协议，核心功能免费使用，代码公开。
还差什么
虽然发到了 1.0.0，但 Markra 还有很多可以继续打磨的地方。
工作区的边界情况还可以更稳，比如一些复杂的文件移动、外部同步工具同时修改文件时的处理。
AI 编辑预览还可以更聪明，尤其是长文档、多处改动和冲突解决。
知识组织能力还比较克制。现在有大纲、搜索、标签页和双链补全，但还没有做成完整知识库系统。
导出模板也可以更丰富，比如更适合论文、产品文档、博客发布的模板。
移动端短期内暂时不打算做。Markra 目前还是优先把桌面端和 Web 端写作体验打磨好。
写在最后
Markra 不是要取代 Typora、Obsidian 或 VS Code。
Typora 的 live preview 体验依然很舒服，Obsidian 仍然是很强的个人知识库，VS Code 也适合工程化写作。只是我自己的需求更偏向一个轻量、所见即所得、本地优先，又能自然使用 AI 的 Markdown 编辑器。
所以我把它做了出来，并慢慢打磨到了 1.0.0。
如果你也有类似需求，可以试试：
官网：
Web 版：
桌面版：
https://github.com/markrahq/markra/releases/latest
源码：
https://github.com/markrahq/markra
欢迎提 issue，也欢迎 PR。
