命令列工具

免費的 marsdawn 命令列工具：在 MarsDawn 中開啟 Markdown 檔案，或從終端機、LLM agent 匯出成 PDF。

marsdawn 免費、另外發佈，不透過 Mac App Store。目前尚未發佈到 Homebrew，需要用 Swift Package Manager 自行建置。兩個指令都需要先安裝 MarsDawn。

安裝

下載原始碼，並用 Swift Package Manager 執行：

git clone https://github.com/redtear1115/mars-dawn-kit.git
cd mars-dawn-kit
swift run marsdawn open notes.md

指令

marsdawn open

在 MarsDawn 中開啟一個或多個 Markdown 檔案，方便審閱。需要先安裝 MarsDawn。

marsdawn open notes.md

--json：印出 JSON 結果，而不是文字。

marsdawn export

把 Markdown 檔案輸出成分頁的 PDF，使用和 MarsDawn 輸出 PDF 相同的元件。同樣需要先安裝 MarsDawn。相對路徑的圖片，會以輸入檔案所在的資料夾為準。

marsdawn export notes.md -o notes.pdf --theme classic --paper a4

-o, --output <path>：PDF 的輸出位置，預設是把輸入檔的副檔名換成 .pdf。
--theme <dawn|classic|modern|vivid>：預覽主題的淺色版本，預設讀取 $MARSDAWN_THEME，否則用 dawn。
--paper <a4|letter>：紙張大小，預設 a4。
--allow-remote-images：輸出時載入網路圖片，預設關閉。
--force：如果輸出檔已存在就直接覆蓋。
--json：印出 JSON 結果，而不是文字。

$MARSDAWN_THEME 環境變數

沒有傳入 --theme 時，export 會讀取 $MARSDAWN_THEME 環境變數，值必須是 dawn、classic、modern 或 vivid 其中之一，其他值都會改用 dawn。這個工具不會讀取 App 本身的主題設定，因為讀取其他 App 的容器可能觸發 macOS 隱私權提示。

覆蓋檔案的規則

export 預設不會覆蓋已存在的輸出檔，除非加上 --force。

結束代碼

0：成功。
2：找不到輸入檔。
3：尚未安裝 MarsDawn。
4：輸出檔已存在（可加上 --force）。
5：輸出失敗。
64：使用方式錯誤。

--json 輸出

成功時，marsdawn open --json 會印出 ok、opened（檔案路徑）與 app（App 路徑）；marsdawn export --json 會印出 ok、output、pages、theme、paper 與 diagramErrors。失敗時兩者都會印出 ok、error 與 message。

需要先安裝 MarsDawn

open 和 export 都需要先從 Mac App Store 安裝 MarsDawn；export 雖然使用和 App 相同的元件，仍會先檢查 App 是否已安裝。