Markra - 原生支持 AI 的开源所见即所得 Markdown 编辑器

本文介绍 Markra，一个完全开源、免费使用的所见即所得 Markdown 编辑器。它围绕原生 AI 能力构建，让你像写成稿一样写 Markdown，同时保留纯文本格式的开放、轻量和可迁移性。

项目简介

Markra 是一个开源的桌面端 Markdown 编辑器项目，由个人开发者 murongg 创建维护。截至目前，该项目在 GitHub 上已获得 94 stars，主要使用 TypeScript 编写。

Markra 的核心理念是：AI 不应是一个外置聊天窗口，而应是编辑流程的一部分。它可以理解当前选区、整篇文档、标题结构和附近的 Markdown 文件，帮助你润色、改写、续写、总结或翻译内容。写入类操作会先以预览形式呈现，确认后才真正改动文档。

核心特性

1. 所见即所得 Markdown 编辑

• 像写成稿一样编辑 Markdown，无需在源码和预览之间来回切换
• 支持常用 Markdown、GFM 表格、链接、图片、列表和代码块
• 表格、链接和图片可在同一编辑界面继续调整
• 保留 Markdown 的纯文本格式和可迁移性
• 可调整正文宽度，适配长文、笔记和方案等不同场景

2. 原生 AI 支持

• 选中文本即可调用内联 AI 命令，无需离开编辑器
• 内置润色、改写、续写、总结、翻译等快捷操作
• Markra AI 侧边栏处理整篇文档和工作区级任务
• 支持 AI 会话搜索、归档、重命名、恢复和删除
• AI 写入先生成编辑器预览，由用户选择应用、拒绝或复制

3. 完全开源，免费使用

• 源码开放，产品方向和实现透明
• 核心写作能力不设付费墙
• 使用 AGPL-3.0 许可证，欢迎社区贡献

4. 本地 Markdown 工作区

• 可打开单个 Markdown 文件或整个 Markdown 文件夹
• 文档和工作区数据默认保存在本机，无需云账号
• 文件树中浏览、新建、重命名和删除文档
• 大纲视图快速跳转，本地预览图片
• 实时保存状态、未保存提醒和字数统计

5. 多模型与多服务商 AI

Markra 支持云端模型、本地模型和 OpenAI 兼容服务，可为内联编辑和 AI 侧边栏分别选择模型：

• OpenAI、Anthropic、Google Gemini、DeepSeek、Mistral
• Groq、OpenRouter、Together.ai、Qwen、Xiaomi MiMo
• Volcengine Ark、xAI、Azure OpenAI
• Ollama 本地模型
• 自定义 OpenAI 兼容服务商和自定义请求 Header

6. 可控的联网搜索

• 使用受支持服务商的原生联网搜索能力
• 配置本地 Bing 搜索或 SearXNG 搜索
• 只在任务需要时启用，可限制搜索结果数量和网页正文读取长度

技术栈

• Tauri - 跨平台桌面应用框架
• TypeScript - 主要开发语言
• React - 前端 UI 框架
• WYSIWYG Markdown - 所见即所得编辑器引擎

适用场景

• 产品文档、需求说明和发布说明
• 博客、长文、Newsletter 和访谈整理
• 读书笔记、研究资料和个人知识库
• 需要反复润色、重组或扩写的 Markdown 内容
• 希望文件留在本地，同时让 AI 理解上下文的写作流程

设计理念

• 本地优先：文件和工作区数据保存在本机磁盘，不锁入私有格式或托管存储
• 开源免费：核心能力开源免费，可查看源码、理解实现、参与改进
• 写作优先：文件管理、AI 和设置都服务于写作本身，界面保持安静
• 确认后再应用：AI 可提出修改，但不会静默覆盖文档，重要编辑以预览呈现

开始使用

1. 打开 Markra
2. 选择一个 Markdown 文件，或打开一个包含 Markdown 文件的文件夹
3. 直接写作，或选中文本唤起内联 AI 操作
4. 在设置里启用想要使用的 AI 服务商和模型
5. 需要处理整篇文档或工作区内容时，打开 Markra AI 侧边栏

项目链接

• GitHub 仓库：murongg/markra
• 许可证：AGPL-3.0