MarsDawn

Mac のコマンドラインで、Markdown を PDF に。

無料の marsdawn ツールは、コマンド1つで Markdown ファイルを PDF に変換します。表、数式、Mermaid 図、ハイライトされたコードはソースの見た目そのままに仕上がり、MarsDawn アプリすら含め、他に何もインストールする必要はありません。

インストール

brew install redtear1115/tap/marsdawn
marsdawn --version

Apple シリコンの Mac では、Homebrew がビルド済みのコピーを数秒でインストールします。Intel Mac ではソースからビルドするため数分かかり、Xcode 26 以降が必要です。macOS 15 以降で動作し、marsdawn --version がインストールされたバージョンを表示します。

文書を保存する

plan.md という名前のファイルに、次の内容を貼り付けてください。

# 計画：エクスポートを高速化

この計画はエージェントが書きました。内容を確認してから、PDF にします。

## ステップ

| ステップ | 担当 | 状況 |
|------|-------|--------|
| 遅いページを計測する | エージェント | 完了 |
| レンダリング済み図をキャッシュする | エージェント | レビュー中 |

50 ページの文書で目標とするのは $t < 2\,\text{s}$：

$$
t_{\text{total}} = \sum_{i=1}^{n} t_i
$$

```mermaid
graph LR
  ドラフト --> レビュー --> 公開
```

```swift
let pdf = try export("plan.md")
```

書き出す

marsdawn export plan.md

ソースの隣に plan.pdf を書き出し、保存先を表示します。

Exported /Users/you/plan.pdf (1 page)

これはそのページを、marsdawn 0.5.0 の実行結果から実際にキャプチャしたものです。

書き出された PDF：見出し、ステップの表、インラインと独立した数式、ドラフト・レビュー・公開の図、ハイライトされた Swift のコード1行。

テーマ、用紙サイズ、ファイル名を選ぶ

marsdawn export plan.md --theme classic --paper letter -o handout.pdf

うまくいかない場合

次に