mcpField
H
html-to-pptx

html-to-pptx

github.com/nlj626ドキュメント1197 回インストール28 週間前に更新
リポジトリ

html-to-pptx について

HTML プレゼンテーションを各ページの画像として撮影し、PPTX にまとめるスキルです。HTML の資料を PPTX 形式で共有する用途向けで、出力内のテキストは編集できません。

主な機能

  1. 01headless Chrome によるスライド描画
  2. 02pptxgenjs による画像の組み立て
  3. 03ページ数の自動検出または指定
  4. 04アスペクト比と画像品質の設定

活用シーン

  1. 01HTML の資料を PPTX として書き出す
  2. 02PPTX のみ受け付ける相手に HTML 資料を共有

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nlj626/html-to-pptx --skill html-to-pptx

インストール後、Claude Code で/html-to-pptxを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
.gitignore
README.md
scripts/
html-to-pptx.sh
render.sh
html-to-pptx.cjs

詳細

プロジェクトの README より

html-to-pptx — HTML 演示文稿转 PPTX

将 html-ppt 生成的 HTML 演示文稿一键转换为 .pptx 文件。

Agent 使用指南

当用户说"导出 PPTX"、"转成 PPT"、"HTML 变 PPTX"或类似的话时：

  1. 确认 HTML 文件路径 — 通常在 ~/.claude/skills/html-ppt/examples/<deck-name>/index.html，或用户指定的路径
  2. 运行转换命令： 
    bash ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.sh <html文件路径>
  3. 报告结果 — 告诉用户 PPTX 文件的路径和大小
  4. 可选参数：
    • --ratio 4:3 — 指定宽高比（支持 16:9、4:3、3:4、1:1）
    • -- --quality 80 — 指定 JPEG 质量（1-100，默认 92）
    • -- --quality png — 强制 PNG 格式（无损但文件较大）

工作原理

  1. headless Chrome 截图：逐页将 HTML 渲染为 PNG 图片（支持 #/N 深度链接）
  2. pptxgenjs 组装：将图片按顺序嵌入 PPTX，每张铺满整页

因为是截图方式，PPTX 会 100% 还原 HTML 的视觉效果，包括字体、颜色、布局、渐变等。

命令参考

# 自动检测页数
bash scripts/html-to-pptx.sh /path/to/deck/index.html

# 指定页数
bash scripts/html-to-pptx.sh /path/to/deck/index.html 8

# 4:3 宽高比
bash scripts/html-to-pptx.sh /path/to/deck/index.html all --ratio 4:3

# 指定 JPEG 质量（更小文件）
bash scripts/html-to-pptx.sh /path/to/deck/index.html all -- --quality 80

# 无损 PNG 格式
bash scripts/html-to-pptx.sh /path/to/deck/index.html all -- --quality png

输出文件与 HTML 同目录，文件名相同但扩展名为 .pptx。

依赖

  • Google Chrome：macOS 默认路径 /Applications/Google Chrome.app
  • pptxgenjs：npm install -g pptxgenjs

注意事项

  • 输出的 PPTX 中每页是一张图片，不可编辑文字（但视觉效果完美还原）
  • 如果需要可编辑文字的 PPTX，应使用 pptx skill 从头创建
  • 适合场景：需要将 html-ppt 作品分享给只接受 PPTX 格式的同事/客户

コメント

Markdown 対応