markdown-to-slides

name	markdown-to-slides
description	MarkdownファイルをPowerPointプレゼンテーション（PPTX）に変換するSkill。 「Markdownをスライドに変換して」「プレゼン資料を作って」「PPTXを生成して」 などのリクエストで自動発火する。python-pptxライブラリを使用。
allowed-tools	Bash, Read, Write, Glob

Markdown → スライド変換 Skill

MarkdownドキュメントをPowerPointプレゼンテーションに変換します。

クイックスタート

python scripts/md2slides.py input.md output.pptx

Markdown記法

スライド区切り

記法	動作
# 見出し1	タイトルスライドを作成
## 見出し2	新しいコンテンツスライドを作成
---	強制的にスライドを分割

サポートする要素

• 太字 と 斜体 テキスト
• 箇条書きリスト（2階層までネスト可）
• 番号付きリスト
• コードブロック（等幅フォントで表示）
• 画像 ![alt](path) （ローカルパスのみ）

ワークフロー

1. ソースMarkdownを読み込む - Readツールでコンテンツ取得
2. PPTXに変換 - 変換スクリプトを実行
3. 出力を確認 - 生成ファイルの存在確認

スクリプトインターフェース

入力

python scripts/md2slides.py <input.md> [output.pptx] [--title "タイトル"]

出力

• 成功: 出力パスを stdout に表示、終了コード 0
• 失敗: エラーを stderr に表示、終了コード 1

オプション

• --title: プレゼンテーションタイトルを上書き（デフォルト: 最初のH1またはファイル名）
• --theme: カラーテーマ（default, dark, corporate）
• --aspect: アスペクト比（16:9, 4:3）デフォルト: 16:9

エラーハンドリング

エラー	原因	対処
入力ファイルが見つからない	パスが間違っている	パスを確認
無効なMarkdown	構文エラー	該当箇所をスキップして警告
画像が見つからない	パスが間違っている	プレースホルダーを表示

使用例

基本的な使い方

python scripts/md2slides.py presentation.md slides.pptx

オプション指定

python scripts/md2slides.py notes.md output.pptx --title "Q4レビュー" --theme corporate

テスト実行

cd /path/to/markdown-to-slides
pytest tests/ -v

依存関係

• python-pptx（Claude API環境ではプリインストール済み）
• 標準ライブラリのみ（パース処理）

ファイル構成

markdown-to-slides/
├── SKILL.md           # このファイル
├── scripts/
│   ├── md2slides.py   # CLIエントリポイント
│   ├── parser.py      # Markdownパース
│   └── generator.py   # PPTX生成
├── tests/
│   └── test_md2slides.py
└── resources/
    └── example.md     # サンプル入力