build

name	build
description	スライドビルド - Marpスライドを `--no-stdin` 付きで HTML/PDF 出力する
argument-hint	<slide-file.md>
allowed-tools	Bash(npx *) Bash(rm *) Bash(ls *) Read Glob

スライドビルド

Marpスライドのビルドとプレビューを行います。

使い方

/build <ファイル名> でスライドをビルドします。

ビルドワークフロー

重要:

• --no-stdin を付けないとstdin待ちでハングします。必ず付与してください。
• ビルド前に既存の出力ファイル（HTML/PDF）を削除してからビルドする。 キャッシュによる古い出力を防ぐため。

1. ファイルパスの確認

# 対象Markdownを確認
ls <slide-file.md>

2. HTML出力（プレビュー用）

rm -f <output.html>
npx marp <slide-file.md> --html --allow-local-files -o <output.html> --no-stdin

3. PDF出力（配布用）

rm -f <output.pdf>
npx marp <slide-file.md> --pdf --allow-local-files -o <output.pdf> --no-stdin

4. HTMLとPDFを連続生成

rm -f <output.html> <output.pdf>
npx marp <slide-file.md> --html --allow-local-files -o <output.html> --no-stdin
npx marp <slide-file.md> --pdf --allow-local-files -o <output.pdf> --no-stdin

5. ライブプレビュー（編集しながら確認）

npx marp <slide-file.md> --html --allow-local-files --watch --no-stdin

ビルド後の確認

ビルドが完了したら、出力ファイルの存在を確認してください。

ls -la <output.html> <output.pdf>

エラーが発生した場合の対処:

• --no-stdin の付け忘れ → stdin待ちでハング（Ctrl+Cで中断し再実行）
• --allow-local-files の付け忘れ → ローカル画像が表示されない
• 画像パスのミス → Markdownの配置を基準に相対パスを確認

プレビュー

• ビルド後に毎回 open しない
• 確認が必要な場合のみ、該当ページを指定して開く

出力ファイルの使い分け

形式	用途
HTML	ローカルプレビュー、ブラウザで確認
PDF	配布用、印刷用