スキル一覧に戻る
knishioka

markdown-to-slides

by knishioka

7🍴 1📅 2025年11月28日
GitHubで見るManusで実行

SKILL.md


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     # サンプル入力

スコア

総合スコア

50/100

リポジトリの品質指標に基づく評価

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です