md-to-pdf

Markdown を PDF に変換

crossnote（mcp-printer と同じエンジン）を使用して、Markdown ファイルを美しく整形された PDF に変換します。

特長

• Mermaid 図 — フローチャート、シーケンス図など
• 数式 — KaTeX によるレンダリング
• 構文ハイライト — GitHub テーマ
• ページ番号 — X / Y ページ形式のフッターを自動表示
• GitHub-light テーマ — 印刷に最適化されたすっきりとしたスタイル

使用方法

~/.claude/skills/md-to-pdf/scripts/md-to-pdf.cjs input.md              # Creates input.pdf
~/.claude/skills/md-to-pdf/scripts/md-to-pdf.cjs input.md output.pdf   # Custom output name

オプション

フラグ	説明
-o FILE	出力ファイル名を指定します

必要条件

• Chrome または Chromium — macOS/Linux では自動検出されます
• Node.js — スクリプトの実行に必要です
• 依存関係 — スキルのディレクトリで npm install を一度実行してください

仕組み

1. crossnote（Markdown Preview Enhanced エンジン）を使用します
2. ページ番号の設定をフロントマターに挿入します
3. Chrome/Puppeteer でレンダリングします
4. Mermaid、数式、コードのハイライトを標準でサポートします

例

# Quick conversion
~/.claude/skills/md-to-pdf/scripts/md-to-pdf.cjs README.md

# Spec document for sharing
~/.claude/skills/md-to-pdf/scripts/md-to-pdf.cjs spec.md spec-v2.pdf

# Multiple files
for f in docs/*.md; do ~/.claude/skills/md-to-pdf/scripts/md-to-pdf.cjs "$f"; done

Mermaid の例

Markdown に以下を記述します。

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do something]
    B -->|No| D[Do something else]
```

図は PDF 内でグラフィックとしてレンダリングされます。

印刷

PDF を印刷する場合は、生成後に /print スキルを使用します。

ワークフローの選択：

ユーザーの意図	操作
「PDF に変換」	PDF を保持します
「この Markdown を印刷」	PDF を生成 → /print で印刷 → PDF を削除します
「PDF を作成して印刷」	PDF を保持し、印刷もします

PDF 自体ではなく印刷が目的の場合は、印刷後に PDF を削除します。

# Generate, print, cleanup
~/.claude/skills/md-to-pdf/scripts/md-to-pdf.cjs doc.md
~/.claude/skills/print/scripts/print doc.pdf
rm doc.pdf

/print スキルが両面印刷と白黒印刷のデフォルト設定を自動的に処理します。

エイリアス（任意）

シェルのプロファイルに追加します。

alias md-to-pdf='~/.claude/skills/md-to-pdf/scripts/md-to-pdf.cjs'