creating-marp-slides

toku345's avatarfrom toku345

このプロジェクトでの Marp スライド作成ルール。スライド作成、画像配置、ビルド、プレビュー時に使用。画像は slides/images/ に配置、bun run preview/build を使用。

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 23, 2025⬇️2downloads

When & Why to Use This Skill

This Claude skill provides a standardized workflow for creating professional presentations using Marp and Markdown. It streamlines the slide development process by enforcing specific rules for image management, directory structures, and automated build commands using Bun, ensuring seamless previews and high-quality exports in HTML, PDF, and PPTX formats.

Use Cases

  • Technical Presentations: Rapidly generating developer-centric slide decks directly from Markdown files within a coding environment.
  • Standardized Asset Management: Ensuring all slide images are correctly placed and referenced to prevent broken links during Marp CLI previews and builds.
  • Automated Documentation Workflows: Integrating slide generation into CI/CD or local development loops using Bun-based build scripts for consistent output.
namecreating-marp-slides
descriptionこのプロジェクトでの Marp スライド作成ルール。スライド作成、画像配置、ビルド、プレビュー時に使用。画像は slides/images/ に配置、bun run preview/build を使用。

Marp スライド作成スキル

本プロジェクトにおける Marp スライド作成の固有ルールと設定。

画像配置(重要)

スライドで使用する画像は 必ず slides/images/ に配置。

![](./images/diagram.png)
![bg right:40%](./images/photo.jpg)

理由: Marp CLI サーバーモードはルート以下のみ配信。他の場所では CLI プレビューで表示されない。 参考: GitHub Issue #163

ファイル配置

種類 パス
スライド slides/*.md
画像 slides/images/
カスタムテーマ themes/*.css
出力 dist/

開発コマンド

# プレビュー(ルートから実行)
bun run preview
# → http://localhost:8080/slides/[ファイル名].md

# ビルド
bun run build        # HTML + PDF
bun run build:html   # HTML のみ
bun run build:pdf    # PDF のみ
bun run build:pptx   # PPTX のみ

設定(.marprc.yml)

allowLocalFiles: true  # ローカル画像読み込み許可
themeSet: ./themes     # カスタムテーマディレクトリ
html: true             # HTML タグ許可

その他のオプション(inputDir, output 等)については Marp CLI 公式ドキュメント を参照。

Front Matter 必須設定

---
marp: true
theme: default  # または gaia, uncover
paginate: true  # 推奨
---

テーマ選択

  • default: ビジネス向け、シンプル
  • gaia: カラフル、視覚的
  • uncover: ミニマル、テキスト中心

注意: invert クラスは default テーマで最も安定。gaia では期待通りに動作しない場合あり。

詳細リファレンス