MarsDawn
給建造者的前線工具
拿穩地圖。讀過黎明。
給要掌舵 agentic 開發的人用的 Markdown。
在 Mac 上寫，在 iPhone 和 iPad 上讀
需要 macOS 26、iOS 26 或 iPadOS 26 以上
MarsDawn 是讀、檢查 Markdown 的 Mac 原生 app，有分割即時預覽、Mermaid 圖表、KaTeX 數學式、快速查看與 PDF 輸出；可免費試用 14 天，一次付 USD 4.99 解鎖。
# 歡迎使用 MarsDawn ## 版面 | 快捷鍵 | 版面 | |:------:|:-----| | ⌘1 | 只顯示原始碼 | | ⌘2 | 原始碼與預覽並排 | | ⌘3 | 只顯示預覽 | ## 寫作 **粗體**、*斜體*、~~刪除線~~、`行內程式碼`和[連結](https://marsdawn.southern-light.dev/zh-hant/support/)都照常使用。 > 引言左邊會有一條暖色的線。 - [x] 可以打勾的待辦清單 - [ ] 巢狀清單 - 像這樣
歡迎使用 MarsDawn
版面
| 快捷鍵 | 版面 |
|---|---|
| ⌘1 | 只顯示原始碼 |
| ⌘2 | 原始碼與預覽並排 |
| ⌘3 | 只顯示預覽 |
寫作
粗體、斜體、刪除線、行內程式碼和連結都照常使用。
引言左邊會有一條暖色的線。
- 可以打勾的待辦清單
- 巢狀清單
- 像這樣
觀看影片
讀 agent 寫的 Markdown。
- Agent 動筆。你的程式碼助手或寫作 agent 先寫出 Markdown：README、規格文件，或一份筆記。
- 你在 MarsDawn 裡讀。打開檔案，看排版後的頁面，Mermaid 圖表和程式碼上色都在，旁邊就是原始碼。
- Agent 修改。提出修改意見，agent 改好之後，再打開來讀一次。
如何審閱 agent 交回來的東西 · Mac 怎麼開 md 檔
agent 的計畫，執行前先看過。
找出順序不對的那一步，指出是哪一行，再交回給 agent。
- 看改了什麼：agent 一存檔，開著的視窗就從磁碟更新，一步完成，也能撤銷。
- 跳到那一行：marsdawn open plan-checkout-v2.md:10 讓視窗停在第 10 行，預覽裡對應的區塊會閃一下。
- 回給 agent：「拷貝引用」（⌥⌘C）拷貝 plan-checkout-v2.md:10，連同你的意見貼進 agent 的對話。
現在就能做的事
免費的 marsdawn 命令列工具現在就能用。用 Homebrew 安裝：
brew install redtear1115/tap/marsdawnmarsdawn export把 Markdown 檔輸出成 PDF，排版和 MarsDawn 的預覽一樣，不需要 app。marsdawn open在 MarsDawn app 裡開啟檔案，讓你審閱。--json回傳腳本和 agent 能解析的結果。
命令列工具 · 給 AI agent 的 marsdawn 參考 · 給 agent 的 skill · MCP 伺服器
購買前先知道。 MarsDawn 做不到的事
各部分怎麼搭在一起
以 MarsDawn 1.1.1、marsdawn 0.6.4、marsdawn-mcp v0.2.4 為準，各部分目前能做的事。
| 功能 | App 內 | CLI | MCP／skill | 狀態 |
|---|---|---|---|---|
| 打開到某一行 | 停在那一行，預覽區塊閃一下 | marsdawn open notes.md:120（--background 不搶焦點） | open_in_marsdawn；skill 只開一次 | 已推出 |
| 輸出 PDF | 檔案 ▸ 輸出為 PDF⋯（⌥⌘E） | marsdawn export，不需要 app | export_markdown_to_pdf；skill | 已推出 |
| JSON 結果 | — | open、export 加 --json | MCP 回傳同一份 JSON | 已推出 |
| Agent skill | — | marsdawn skill --install | 教 agent 開一次、輸出 PDF | 已推出 |
| MCP 伺服器 | — | 在底下執行 | marsdawn-mcp：兩個工具，只碰允許的資料夾 | 已推出 |
| 拷貝給 AI、拷貝引用 | 編輯 ▸ 拷貝給 AI（⌃⌥⌘C）、拷貝引用（⌥⌘C） | — | —（貼給任何 agent） | 已推出 |
| 存檔後自動更新 | 接收存檔的變更，可撤銷一次 | — | skill：不用再開一次 | 已推出 |
| Claude Code hook | — | 用 open --background | /cli/agents/ 的 hook 腳本 | 有文件，選用 |
已推出：在上面寫的發行版本裡。有文件，選用：本站上的說明，要你自己加，不在工具裡。規劃中：還沒做，沒有日期。規劃中：MCP 的 open_in_marsdawn 加上資料夾選項。--folder 等其他選項見命令列工具。
用 coding agent 做 Mac app 的你
寫給獨立 Mac 開發者：你的 agent 現在怎麼把它寫的檔案打開在 MarsDawn 裡。
| 工具 | 怎麼搭配 | 設定 |
|---|---|---|
| Claude Code | skill 會讓它寫完後打開一次，直接停在那一行：marsdawn open plan.md:42。另有選用的 hook，它寫的每個 .md 都會在背景打開 | marsdawn skill --install；hook 腳本見 /cli/agents/ |
| Codex、Cursor、Xcode | 還沒有專屬的設定說明。能跑 shell 指令的工具都能呼叫 marsdawn open file:line --json；會讀指令檔的 agent 可以用 SKILL.md（--dir），只走 MCP 的工具可以用 marsdawn-mcp | brew install redtear1115/tap/marsdawn |
hook 與指令：給 AI agent 的 marsdawn 參考 · 給 agent 的 skill · MarsDawn 做不到的事
在 MarsDawn、VS Code 預覽、Obsidian、QLMarkdown、LynxOffice 之間猶豫？比較頁列出各家自己的說法、MarsDawn 沒有的東西，以及什麼時候用不到它。看比較
文件留在你的 Mac 上
在你的 Mac 上。閱讀、編輯、算繪、輸出 PDF 和 marsdawn 命令列都在本機完成，可以完全離線；App 不會上傳你的文件。
詳見：隱私權政策
預設不連網。網路圖片只有在你按「載入圖片」，或在設定中開啟「自動載入網路圖片」後才會載入；HTML 文件開啟時是靜態的，程式碼不會執行。
詳見：隱私權政策
只在你選擇時離開。「拷貝給 AI」只把文字放進剪貼板，由你自己貼上；下載主題、用「顯示方式 › 執行這份文件」執行的文件，以及你讓 agent 讀的檔案，都要你決定才會往外送。
詳見：隱私權政策
常見問題
MarsDawn 是什麼？
MarsDawn 是 Mac 原生 app，用來讀懂、檢查 agent 寫的 Markdown：原始碼和即時預覽並排，能畫 Mermaid、排 KaTeX，在快速查看裡預覽 .md，也能輸出 PDF。原始碼也可以直接改。
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 指令的 agent，都能呼叫它。另有一個需要自行啟用的 Claude Code hook，可以在 Claude 寫入或編輯 Markdown 檔案時自動開啟。
MarsDawn 會上傳我的文件嗎？
不會。App 不會上傳你的文件，不收集任何關於你的資料，也沒有帳號；文件和設定都留在你的 Mac 上。只有文件引用網路內容、而你選擇載入時，你的 Mac 才會向放置那些內容的伺服器取用，MarsDawn 的開發者收不到這些資訊。
詳見：隱私權政策
用 MCP 或 skill 時，誰能看到我的檔案？
MarsDawn 本身不傳送任何東西。skill 只是一份文字說明，marsdawn 命令列和 MCP 伺服器都在你的 Mac 上執行，MCP 伺服器也只在你允許的資料夾裡動作。真正讀檔的是你的 agent，它和它的模型供應商怎麼處理這些檔案，依照那個 agent 的政策；MarsDawn 無法控制，也不代為說明。
詳見：MCP
打開別人傳給我的 HTML 安全嗎？
預設開啟時是靜態的：程式碼不會執行，也不會從網路載入任何東西。若你選擇「顯示方式 › 執行這份文件」，這份文件就會執行，可以透過網路傳送資料，並讀取它所在資料夾裡的圖片、樣式表、字型與媒體檔案。這個選擇不會被記住，下次打開又是靜態的。
詳見：隱私權政策
網站的分析 cookie 和 App 有關嗎？
沒有關係。App 和這個網站是兩件事：App 不收集資料，會記下造訪的只有 marsdawn.southern-light.dev。網站的 Google Analytics 一開始是拒絕狀態，你在橫幅中選擇「接受」之後才會設定 cookie，頁尾的「Cookie 設定」可以隨時改。App 下載 /themes/ 底下主題檔的請求不會被記錄。
詳見：隱私權政策
為什麼用 MarsDawn，不用別的 App？
你可能不需要它。如果你主要寫自己的筆記，Obsidian 這類筆記 App 更適合。如果你整天待在 VS Code，它內建的預覽是免費的。如果你只想在 Finder 裡瞄一眼檔案，免費的快速查看擴充功能就夠了。如果你的 PDF 需要頁碼，MarsDawn 不會加。MarsDawn 是用來閱讀和審閱 agent 寫的 Markdown：原始碼旁邊就是即時預覽，agent 的修改一步就能撤銷，檔案直接開到指定的那一行。如果它不合用，歡迎寫信告訴我們原因。
詳見：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 而做
- 原生的 Mac 視窗。
- Mac 原生的文字編輯器，附 Markdown 語法上色。
- ⌘1 原始碼、⌘2 並排、⌘3 預覽。
- 頁面會隨著打字更新。
輸出 PDF
- Mermaid 圖表直接畫進 PDF。
- 程式碼保留語法上色。
Markdown 的新黎明。 MarsDawn 已在 Mac App Store 上架。
