Markdown 编辑器这些年已经很多了。有人喜欢 Typora 那种干净的实时预览,有人把 Obsidian 当作个人知识库,也有人只想找一个能安心写文章、整理文档、顺手调用 AI 的工具。Markra 的定位就落在这个位置:它不是想做一个大而全的知识管理系统,而是更像一个带 AI 能力的本地 Markdown 文档编辑器。

从官方介绍看,Markra 是一款原生支持 AI 的所见即所得 Markdown 编辑器,完全开源、免费使用,并强调数据默认保留在本地。它既提供桌面应用,也提供 Web 编辑器,用户可以打开本地 Markdown 文件或文件夹,在可视化编辑和源码模式之间切换。

Markra:一款开源本地优先的 AI Markdown 编辑器

它解决的不是“写不写 Markdown”

很多人不用 Markdown,并不是因为语法难,而是因为写作过程不够顺。表格、图片、链接、代码块、数学公式、Mermaid 图表这些内容,在纯源码里改起来并不轻松。Markra 的思路是把 Markdown 文件仍然保留为普通 .md 文件,但编辑过程尽量接近文档编辑器。

这对写博客、产品文档、技术说明、研究笔记的人比较实用。你可以享受 Markdown 文件轻量、开放、好迁移的好处,又不用一直盯着语法符号写作。需要看源码时,也能切回源代码模式。

本地优先是重点

Markra 官方反复强调 local-first,也就是本地优先。文件默认保存在用户磁盘上,不要求账号登录,也不是把所有文档先上传到云端再编辑。对经常写私有笔记、项目文档、草稿和技术资料的人来说,这一点比较重要。

不过,本地优先不等于所有功能都永远离线。根据官方说明,WebDAV 同步、远程图片存储、AI 请求等功能只有在用户配置相关服务后才会联系外部服务。也就是说,Markra 的边界更接近“默认本地,按需连接外部服务”。

AI 不是简单聊天框

Markra 的 AI 功能不是只在旁边放一个聊天窗口。它提供选中文本后的内联 AI 操作,也提供侧边栏处理更完整的文档任务。官方列出的快捷动作包括润色、重写、续写、总结和翻译。

比较值得注意的是,Markra 强调 AI 修改在应用前可以预览。用户可以先看 AI 改了什么,再选择接受、拒绝或复制。这种设计比“直接替换原文”更适合正式写作,尤其是技术文档、博客文章和需要保留语气的内容。

它还支持多种 AI 服务,包括 OpenAI、Anthropic、Google Gemini、DeepSeek、Mistral、Groq、OpenRouter、Qwen、Azure OpenAI、Ollama 等,以及 OpenAI 兼容接口。本地模型和云端模型都可以成为选择,但具体可用性仍取决于用户自己的配置和服务权限。

编辑能力比较完整

Markra 支持所见即所得 Markdown 编辑,也保留源码模式。常见的 Markdown 扩展内容,如链接、图片、HTML、KaTeX 数学公式、Mermaid 图表、GFM 表格等,可以在编辑区内渲染。需要时也可以展开回源码处理。

它还提供斜杠命令、块级拖拽、写作宽度调整、字体大小和行高设置。桌面端有本地拼写检查能力,官方说明它使用 Markra 管理的本地词典,而不是完全依赖系统或 Electron 的拼写检查。

对于技术写作者来说,代码块、表格、GitHub 风格提示块也比较实用。比如 note、tip、important、warning、caution 这类 callout,适合写文档时标注提醒、限制和风险说明。

Markra:一款开源本地优先的 AI Markdown 编辑器

文件和工作区

Markra 不只是单文件编辑器。它支持打开单个文件或整个文件夹,在文件树中浏览、创建、重命名、移动、删除和排序文件。桌面端还支持标签页、并排窗格、快速打开、工作区搜索、目录导航和双中括号链接补全。

这让它更接近一个写作工作台。比如写一个产品文档库、维护一组博客草稿、整理项目说明时,不需要每次只打开单个 Markdown 文件。

自动保存、恢复标签页和工作区状态、字数统计等细节,也说明它不是只为演示而做的编辑器,而是在考虑长时间写作时的连续性。

同步、图片和导出

Markra 的同步和存储设计比较克制。它支持本地备份,也支持可选 WebDAV 同步,用于在设备之间保持笔记对齐,并保留冲突副本。图片方面,可以粘贴或拖放到本地文件夹、WebDAV、PicGo/PicList 或 S3 兼容存储。

导出方面,桌面端支持导出为独立 HTML、PDF,以及在配置 Pandoc 后导出更多格式;Web 版本则提供 HTML 下载和浏览器打印/PDF 能力。对于写博客和技术资料的人来说,HTML 和 PDF 导出已经覆盖不少日常场景。

桌面端和 Web 端有差异

Markra 同时提供桌面应用和 Web 编辑器,但两者不是完全一样。桌面应用在本地文件访问、文件监听、拼写检查、本地备份、WebDAV 同步、图片存储和导出能力上更完整。Web 编辑器受浏览器权限和 CORS 等限制,适合轻量体验或临时编辑。

能力桌面端Web 编辑器
Markdown 编辑完整编辑体验完整编辑体验
本地文件和文件夹原生文件对话框、路径和监听依赖浏览器文件选择和权限
拼写检查支持本地词典和个人词库官方说明暂不可用
备份和同步本地备份、WebDAV 同步官方说明 Web 运行时暂不可用
AI 请求通过原生运行时请求,并支持应用代理设置受提供商 CORS 支持影响

和 Typora、Obsidian 的差异

官方对比中,Markra 更接近“本地优先 Markdown 写作 + 内置 AI 编辑”的组合。Typora 更偏极简实时预览写作,Obsidian 更偏个人知识库、双链、图谱和插件生态。

如果只想要一个成熟、极简、专注写 Markdown 的工具,Typora 仍然有自己的优势。如果想做长期知识库、双链笔记、插件扩展,Obsidian 更完整。Markra 的吸引点在于:它保留本地 Markdown 文件,又把 AI 修改、预览确认、文件工作区、导出和多模型配置放进了同一个写作流程。

适合哪些人

  • 经常写博客、产品文档、技术文档,希望保留 Markdown 文件的人。

  • 需要 AI 辅助润色、翻译、总结,但不想让 AI 直接覆盖原文的人。

  • 在意本地文件可控性,不希望写作工具强绑定云端账号的人。

  • 需要表格、代码块、数学公式、Mermaid 图表等技术写作能力的人。

  • 想尝试开源 Markdown 编辑器,并愿意接受项目仍在持续演进的人。

参考资料

  1. Markra GitHub 项目

  2. Markra 中文 README

  3. Markra 最新发布版本

  4. Markra 官方网站