MarsDawn

给建造者的前线工具

拿稳地图。读过黎明。

给要掌舵 agentic 开发的人用的 Markdown。

在 App Store 下载 安装免费的 CLI

在 Mac 上写，在 iPhone 和 iPad 上读

MarsDawn 是读、检查 Markdown 的 Mac 原生 app，有分栏实时预览、Mermaid 图表、KaTeX 数学公式、快速查看与 PDF 导出；可免费试用 14 天，一次付 USD 4.99 解锁。在 Mac 上也能打开 JSON 和 YAML，附树状预览。

欢迎使用 MarsDawn
主题
外观
预览主题
浅色
深色
布局 
# 欢迎使用 MarsDawn

## 布局

| 快捷键 | 布局 |
|:------:|:-----|
| ⌘1 | 仅显示源代码 |
| ⌘2 | 源代码与预览并排 |
| ⌘3 | 仅显示预览 |

## 写作

**粗体**、*斜体*、~~删除线~~、`行内代码`和[链接](https://marsdawn.southern-light.dev/zh-hant/support/)都照常使用。

> 引文左侧会有一条暖色的线。

- [x] 可以勾选的待办清单
- [ ] 嵌套列表
  - 像这样

欢迎使用 MarsDawn

布局

快捷键布局
⌘1仅显示源代码
⌘2源代码与预览并排
⌘3仅显示预览

写作

粗体、斜体、删除线、行内代码和链接都照常使用。

引文左侧会有一条暖色的线。

  • 可以勾选的待办清单
  • 嵌套列表
    • 像这样
iPhone 上的 MarsDawn，显示代理写的结账计划和一张 Mermaid 流程图，黎明主题浅色

离开座位，也能读代理写的东西

  1. 在 Mac 上，让代理把文件存进 iCloud 云盘里的文件夹。
  2. 在 iPhone 或 iPad 上打开 MarsDawn，选择那份文件。
  3. 要修改或导出 PDF，回到 Mac 上操作。

在 iPhone 和 iPad 上只能阅读，只能打开 Markdown 和纯文本文件。

在 App Store 下载

进一步了解 iPhone 和 iPad 版

观看影片

30 秒：代理在 Mac 上写，你在 iPhone 上读。（繁体中文字幕）

读代理写的 Markdown。

  1. 代理动笔。你的代码助手或写作代理先写出 Markdown：README、规格文档，或一份笔记。
  2. 你在 MarsDawn 里读。打开文件，看排版后的页面，Mermaid 图表和代码高亮都在，旁边就是源代码。
  3. 代理修改。提出修改意见，代理改好之后，再打开来读一次。

如何审阅代理交回来的东西 · Mac 上怎么打开 md 文件

代理的计划，运行前先看过。

找出顺序不对的那一步，指出是哪一行，再交回给代理。

  1. 看改了什么：代理一保存，打开的窗口就从磁盘更新，一步完成，也能撤销。
  2. 跳到那一行：marsdawn open plan-checkout-v2.md:10 让窗口停在第 10 行，预览里对应的区块会闪一下。
  3. 交回给代理：“拷贝引用”（⌥⌘C）拷贝 plan-checkout-v2.md:10，连同你的意见粘贴进代理的对话。

现在就能做的事

免费的 marsdawn 命令行工具现在就能用。用 Homebrew 安装：

brew install redtear1115/tap/marsdawn
  • marsdawn export 把 Markdown 文件导出成 PDF，排版和 MarsDawn 的预览一样，不需要 app。
  • marsdawn open 在 MarsDawn app 里打开文件，让你审阅。
  • --json 返回脚本和代理能解析的结果。

命令行工具 · 给 AI 代理的 marsdawn 参考 · 给代理的 skill · MCP 服务器

购买前先知道。 MarsDawn 做不到的事

各部分怎么搭在一起

以 MarsDawn 1.1.1、marsdawn 0.6.4、marsdawn-mcp v0.2.4 为准，各部分目前能做的事。

功能App 内CLIMCP／skill状态
打开到某一行停在那一行，预览区块闪一下marsdawn open notes.md:120（--background 不抢焦点）open_in_marsdawn；skill 只打开一次已推出
导出 PDF文件 ▸ 导出为 PDF…（⌥⌘E）marsdawn export，无需 appexport_markdown_to_pdf；skill已推出
JSON 结果—open、export 加 --jsonMCP 返回同一份 JSON已推出
代理技能—marsdawn skill --install教代理打开一次、导出 PDF已推出
MCP 服务器—在底层运行marsdawn-mcp：两个工具，只碰允许的文件夹已推出
拷贝给 AI、拷贝引用编辑 ▸ 拷贝给 AI（⌃⌥⌘C）、拷贝引用（⌥⌘C）——（粘贴给任何代理）已推出
保存后自动更新接收保存的更改，可一次撤销—skill：不用再打开一次已推出
Claude Code hook—用 open --background/cli/agents/ 的 hook 脚本有文档，可选

已推出：在上面写的发行版本里。有文档，可选：本站上的说明，需要你自己添加，不在工具里。计划中：还没做，没有日期。计划中：MCP 的 open_in_marsdawn 加上文件夹选项。--folder 等其他选项见命令行工具。

用 coding 代理做 Mac app 的你

写给独立 Mac 开发者：你的代理现在怎么把它写的文件在 MarsDawn 里打开。

工具怎么搭配设置
Claude Codeskill 会让它写完后打开一次，直接停在那一行：marsdawn open plan.md:42。另有可选的 hook，它写的每个 .md 都会在后台打开marsdawn skill --install；hook 脚本见 /cli/agents/
Codex、Cursor、Xcode还没有专门的设置说明。能运行 shell 命令的工具都能调用 marsdawn open file:line --json；会读取指令文件的代理可以用 SKILL.md（--dir），只走 MCP 的工具可以用 marsdawn-mcpbrew install redtear1115/tap/marsdawn

hook 与命令：给 AI 代理的 marsdawn 参考 · 给代理的 skill · MarsDawn 做不到的事

在 MarsDawn、VS Code 预览、Obsidian、QLMarkdown、LynxOffice 之间犹豫？对比页列出各家自己的说法、MarsDawn 没有的东西，以及什么时候用不到它。看对比

文稿留在你的 Mac 上

在你的 Mac 上。阅读、编辑、渲染、导出 PDF 和 marsdawn 命令行都在本机完成，可以完全离线；App 不会上传你的文稿。

详见：隐私政策

默认不联网。网络图像只有在你按“载入图像”，或在设置中打开“自动载入网络图像”后才会加载；HTML 文稿打开时是静态的，代码不会运行。

详见：隐私政策

只在你选择时离开。“拷贝给 AI”只把文字放进剪贴板，由你自己粘贴；下载主题、用“显示 › 运行这份文稿”运行的文稿，以及你让代理读取的文件，都要你决定才会往外送。

详见：隐私政策

常见问题

MarsDawn 是什么？

MarsDawn 是 Mac 原生 app，用来读懂、检查代理写的 Markdown：源文本和实时预览并排，能画 Mermaid、排 KaTeX，在快速查看里预览 .md，也能导出 PDF。源文本也可以直接改。在 Mac 上也能打开 JSON 和 YAML，附树状预览。

MarsDawn 要订阅吗？

不用。MarsDawn 免费下载，14 天内所有功能都能试用；之后一次 USD 4.99 的 App 内购买就能永久解锁。没有任何续订，也不需要账户。

MarsDawn 有 iPhone 或 iPad 版吗？

有，用来阅读。iPhone 和 iPad 上的 MarsDawn 能打开 Markdown 和纯文本文件，排好 Mermaid 图表、数学公式、代码和表格，也有大纲和主题；不能编辑，也不能导出 PDF。需要 iOS 26 或 iPadOS 26 以上。用同一个 Apple 账户，一次试用、一次解锁，就涵盖 Mac、iPhone 和 iPad 上的 MarsDawn。

详见：路线图

Claude Code 可以用 MarsDawn 打开文件吗？

可以。免费的 marsdawn 命令行工具有 open 命令，能用 MarsDawn 打开 Markdown 文件，所以 Claude Code，或任何能执行 shell 命令的代理，都能调用它。另有一个需要自行启用的 Claude Code hook，可以在 Claude 写入或编辑 Markdown 文件时自动打开。

MarsDawn 会上传我的文稿吗？

不会。App 不会上传你的文稿，不收集任何关于你的数据，也没有账户；文稿和设置都留在你的 Mac 上。只有文稿引用网络内容、而你选择加载时，你的 Mac 才会向托管这些内容的服务器获取，MarsDawn 的开发者收不到这些信息。

详见：隐私政策

用 MCP 或 skill 时，谁能看到我的文件？

MarsDawn 本身不发送任何东西。skill 只是一份文字说明，marsdawn 命令行和 MCP 服务器都在你的 Mac 上运行，MCP 服务器也只在你允许的文件夹里操作。真正读取文件的是你的代理，它和它的模型提供方如何处理这些文件，取决于那个代理的政策；MarsDawn 无法控制，也不代为说明。

详见：MCP

打开别人发来的 HTML 安全吗？

默认打开时是静态的：代码不会运行，也不会从网络加载任何东西。如果你选择“显示 › 运行这份文稿”，这份文稿就会运行，可以通过网络发送数据，并读取它所在文件夹里的图片、样式表、字体与媒体文件。这个选择不会被记住，下次打开又是静态的。

详见：隐私政策

网站的分析 cookie 和 App 有关吗？

没有关系。App 和这个网站是两回事：App 不收集数据，会记录访问的只有 marsdawn.southern-light.dev。网站的 Google Analytics 一开始是拒绝状态，你在横幅中选择“接受”后才会设置 cookie，页脚的“Cookie 设置”可以随时更改。App 请求 /themes/ 下主题文件的请求不会被记录。

详见：隐私政策

为什么用 MarsDawn，不用别的 App？

你可能不需要它。如果你主要写自己的笔记，Obsidian 这类笔记 App 更合适。如果你整天待在 VS Code 里，它内置的预览是免费的。如果你只想在访达里瞄一眼文件，免费的快速查看扩展就够了。如果你的 PDF 需要页码，MarsDawn 不会加。MarsDawn 是用来阅读和审阅代理写的 Markdown 的：源文本旁边就是实时预览，代理的修改一步就能撤销，文件直接打开到指定的那一行。如果它不合用，欢迎写信告诉我们原因。

详见：MarsDawn 与其他工具比较 · Mac Markdown 查看器推荐

MarsDawn 会持续维护吗？

会。MarsDawn 上架 Mac App Store 以来的每次更新都在更新记录里；2026 年 10 月 28 日起，iPhone 和 iPad 上也能用 MarsDawn 阅读。MarsDawn 的渲染核心和免费的 marsdawn 命令行工具，已经以 Apache-2.0 许可证在 mars-dawn-kit 开源。如果 MarsDawn 的开发者哪天停止维护这个 App，会以开源许可证公开 App 本身的源代码，让其他人可以接手。

详见：更新记录 · 路线图 · mars-dawn-kit

App 实际的样子

为 Mac 而做

MarsDawn 的并排布局：左边是 Markdown 源代码，右边是排版后的页面。
这张截图里
  1. 原生的 Mac 窗口。
  2. Mac 原生的文本编辑器，附 Markdown 语法高亮。
  3. ⌘1 源代码、⌘2 并排、⌘3 预览。
  4. 页面会随着打字更新。

导出 PDF

用 MarsDawn 导出的 PDF，在内置的 PDF 查看器中打开，旁边有页面缩略图。
这张截图里
  1. Mermaid 图表直接画进 PDF。
  2. 代码保留语法高亮。

Markdown 的新黎明。 MarsDawn 已在 Mac App Store 上架。

在 App Store 下载