如何5分钟上手Markra:macOS/Windows/Linux跨平台安装与快速开始教程

原创2026-10-23 14:38:292,227 阅读

如何5分钟上手Markra:macOS/Windows/Linux跨平台安装与快速开始教程

Markra 是一款完全开源、免费使用的 WYSIWYG Markdown 编辑器,内置原生 AI 写作辅助,支持 macOS、Windows、Linux 三大平台。这篇快速开始教程将带你在 5 分钟内完成 Markra 的安装,并学会打开文档、使用所见即所得模式和 AI 辅助写作——全程无需注册账号,所有文件默认保存在本地磁盘。

Markra Markdown 编辑器演示画面总览

为什么选择 Markra:本地优先的开源 Markdown 编辑器

在动手安装之前,先用 30 秒了解 Markra 的核心理念:

  • 本地优先:文档始终以纯 .md 文件形式保存在你的磁盘上,数据不出机器
  • 原生 AI:AI 不是插件,而是内置功能——选中文字即可润色、改写、续写,且所有修改先预览、确认后写入
  • 开源免费:AGPL-3.0 许可,核心功能不收费、不设功能墙
  • 双模式编辑:所见即所得(WYSIWYG)与源码模式一键切换

更多设计思路可以参考 PRODUCT.md 和 DESIGN.md。

3 分钟完成跨平台安装

Markra 桌面版基于 Tauri 构建,体积小巧。以下按平台给出最快安装路径:

macOS:Homebrew 一行命令安装

如果你有 Homebrew,这是最简单的 macOS 安装方式:

brew install --cask markrahq/tap/markra

没有 Homebrew 也可以直接下载 Apple Silicon / Intel 版安装包,拖入"应用程序"即可。

Windows:安装包或便携版二选一

从项目的官方发布页(Releases)下载最新的 Windows 构建,提供两种形式:

  • 安装包:传统双击安装,适合日常电脑
  • 便携版:绿色免安装,可放在 U 盘里随处使用

💡 便携版小技巧:Markra 支持 --user-data-dir=<路径> 参数,把设置、AI 会话、主题等数据也一并放进 U 盘,实现"整盘带走"。

Linux:AppImage / DEB / RPM / Arch 包全覆盖

官方发布页提供 AppImage、DEB、RPM 和 Arch Linux 包。Arch 用户下载 x64 包后执行:

sudo pacman -U ./Markra_<版本号>_linux_x64.pkg.tar.zst

DEB/RPM 包直接双击或用 apt/dnf 安装;AppImage 赋予可执行权限后直接运行即可。

2 分钟快速上手:从打开文件到第一次写作

安装完成后打开 Markra,只需 3 步:

  1. 打开文件或文件夹:单个 .md 文件或整个文件夹都可以作为工作区
  2. 直接开始写:标题、列表、表格、代码块、公式(KaTeX)、Mermaid 图表都支持实时渲染,输入 / 唤起斜杠命令菜单快速插入块
  3. 随时切换源码:一键切到源码模式查看原始 Markdown 语法

Markra Markdown 编辑器所见即所得工作区界面

几个新手必知的小功能:

  • 文件树管理:左侧可新建、重命名、移动、删除文件,无需离开编辑器
  • 自动保存:已有文件自动保存,重启后自动恢复标签页和工作区状态
  • 拼写检查:内置本地拼写词典,Ctrl/Cmd + . 快速调用修改建议

3 种方式用 Markra 的原生 AI 提升写作效率

Markra 的 AI 能力是内置的,支持 OpenAI、Anthropic、Google Gemini、DeepSeek、Ollama 等主流服务商,也兼容任意 OpenAI 兼容端点。先用再配置,写作不等待。

方式一:选中文本,唤起内联 AI 命令

选中一段文字,直接对 AI 下达指令——润色、改写、续写、总结、翻译都有快捷动作:

Markra Markdown 编辑器原生 AI 内联命令栏

方式二:先预览,再决定是否应用

这是 Markra AI 最让人安心的设计:任何 AI 修改都以预览形式呈现,你可以接受、拒绝或复制,确认前原文一个字都不会变:

Markra Markdown 编辑器 AI 编辑预览对比界面

方式三:打开 AI 侧边栏处理全文任务

需要整篇文档级别的加工(如全文总结、结构优化)时,打开右侧 AI 面板。它会带着文档上下文工作,会话支持搜索、重命名和归档:

Markra Markdown 编辑器 AI 侧边栏对话面板

配置你的 AI 服务商

进入 设置 → AI,选择服务商并填入 API Key 即可。内置服务商列表定义在 packages/providers/src/providers.ts,AI 功能的完整实现位于 packages/ai/src/:

Markra Markdown 编辑器多服务商 AI 设置界面

数据与隐私:你的文件真的只属于你

  • 文档保存在你自己选定的文件夹里,默认不上传任何内容
  • AI 请求只发往你配置的服务商;WebDAV 同步、远程图片存储均为可选项
  • 敏感凭据默认不会包含在设置备份中

详细的隐私与数据流说明见 docs/privacy.md。

新手常见问题

需要注册账号吗? 不需要,安装即用。

没有 API Key 能用吗? 可以。写作、文件管理、导出等全部核心功能不依赖 AI,配置 AI 是可选的。

可以离线使用吗? 桌面版安装后可离线编辑本地文件,仅 AI 和远程同步功能需要联网。

导出格式有哪些? 支持导出为 HTML、PDF,配置 Pandoc 后还支持更多格式。

能换主题吗? 支持自定义 CSS 主题,且兼容 Typora 主题,指南见 packages/app/src/themes/README.md。

下一步:深入探索 Markra

安装只是开始,这些资料可以帮你进一步玩透 Markra:

✅ 到这里,你已经完成了 Markra 的安装与快速上手:一个本地优先、开源免费、AI 原生集成的 Markdown 编辑器。打开你手边的 .md 文件,开始写吧!

登录后查看全文
markra