讓 agent 幫你做出 PDF。

在 Claude Code 中安裝

mkdir -p ~/.claude/skills/marsdawn
curl -fsSL https://marsdawn.southern-light.dev/cli/skill/SKILL.md -o ~/.claude/skills/marsdawn/SKILL.md

需要做出 PDF 時，Claude Code 會自動載入它，你也可以用 /marsdawn 自己執行。它只是一個簡短的檔案，安裝前先讀一遍。

其他 agent 也能用同一個檔案。它是純 Markdown，只有說明和指令，讓你的 agent 讀這個網址，或直接貼給它就好。這個檔案是英文的。

它教什麼

• 如果沒有 marsdawn，就用 Homebrew 安裝，再用 marsdawn --version 確認版本，而不是假設某個版本。
• 用 marsdawn export … --json 匯出，並讀懂結果：PDF 存到哪裡、有幾頁，以及有沒有 Mermaid 圖表沒畫出來。
• 依結束代碼分辨失敗的原因：找不到檔案、PDF 已經存在、匯出失敗、選項錯誤。
• 只有裝了 MarsDawn app 才用 open，而且絕不用它來做 PDF。

它不會做的事

• 它不會自己取得執行任何東西的權限。你的 agent 在安裝或執行 marsdawn 之前，仍然會先問你，就像執行其他指令一樣。
• 它不會把你的文件傳到任何地方。marsdawn 在你的 Mac 上產生 PDF，除非你加上 --allow-remote-images，否則不會載入網路上的圖片。

完整的規格，每個欄位和每個代碼，都在給 AI agent 的 marsdawn 參考裡。