kai-html-export

Category: Tools & Productivity | Uploader: kaisersong | Downloads: 0 | Version: v1.0（Latest）

Changelog: Source: GitHub https://github.com/kaisersong/kai-html-export

Directory Structure

Current level: Root

📁 scripts/
- 📄 export-native-pptx.py 76.5 KB
- 📄 export-pptx.py 9.8 KB
- 📄 screenshot.py 5.4 KB
📁 tests/
- 📁 fixtures/
  - 📄 no_slides.html 253 B
  - 📄 report.html 4.8 KB
  - 📄 scroll_snap_slides.html 1.5 KB
  - 📄 simple_slides.html 805 B
- 📄 run_tests.py 1.9 KB
- 📄 test_pptx.py 9.0 KB
- 📄 test_screenshot.py 5.1 KB
📄 .gitignore 53 B
📄 PPTX_EXPORT_STRATEGY.md 5.4 KB
📄 README.md 5.1 KB
📄 README.zh-CN.md 5.0 KB
📄 SKILL.md 3.5 KB

SKILL.md

---
name: kai-html-export
description: >-
  Export any HTML file to PPTX or PNG. Use when the user wants to convert an
  HTML presentation to PowerPoint, screenshot a web page, or export an HTML
  report as an image. Triggers: /kai-html-export, --pptx, --png,
  "export to pptx", "screenshot html", "convert html to powerpoint",
  "导出为ppt", "导出ppt", "生成ppt", "转成ppt", "导出幻灯片",
  "html转ppt", "保存为ppt", "可编辑的ppt", "native模式", "导出为可编辑".
version: 1.1.3
metadata:
  openclaw:
    emoji: "📤"
    os:
      - darwin
      - linux
      - windows
    requires:
      bins:
        - python3
    install:
      - id: python-pptx
        kind: uv
        package: python-pptx
        label: "python-pptx (PPTX assembly)"
      - id: playwright
        kind: uv
        package: playwright
        label: "Playwright (headless browser for screenshots)"
      - id: beautifulsoup4
        kind: uv
        package: beautifulsoup4
        label: "BeautifulSoup4 (HTML parsing for native export)"
      - id: lxml
        kind: uv
        package: lxml
        label: "lxml (HTML parser backend)"
---

# kai-html-export

Export any HTML file to PPTX or PNG using a headless browser. No Node.js required — uses your existing system Chrome.

## Commands

| Command | What it does |
|---------|-------------|
| `/kai-html-export [file.html]` | Export HTML presentation to PPTX (auto-detects slides) |
| `/kai-html-export --pptx [file.html]` | Explicit PPTX export |
| `/kai-html-export --png [file.html]` | Full-page screenshot to PNG |
| `/kai-html-export --png --scale 2 [file.html]` | 2× resolution screenshot |

If no file is specified, use the most recently modified `.html` file in the current directory.

## Export to PPTX

Run the bundled script:

```bash
python3 <skill-path>/scripts/export-pptx.py <file.html> [output.pptx] [--mode image|native] [--width 1440] [--height 900]
```

### Export Modes

**`--mode image`** (default):
- Pixel-perfect screenshots of each slide
- Visual fidelity: ⭐⭐⭐⭐⭐
- Editability: ❌ None (text is rasterized)
- Best for: archiving, sharing final presentations

**`--mode native`** (new):
- Editable text, shapes, and tables
- Visual fidelity: ⭐⭐⭐ (simplified gradients, no shadows)
- Editability: ✅ Full text editing
- Best for: collaborative editing, content reuse

Supported in native mode:
- Text (h1-h6, p): font size, color, bold, alignment
- Lists (ul, ol): bullet points
- Tables: editable cells
- Shapes (div with solid background): rectangles
- Images: native insertion

Not supported in native mode (fall back to image):
- CSS gradients → solid color approximation
- Box shadows → omitted
- Custom web fonts → system fonts
- SVG graphics → rasterize to PNG

## Export to PNG

Run the bundled script:

```bash
python3 <skill-path>/scripts/screenshot.py <file.html> [output.png] [--width 1440] [--scale 2]
```

- Captures the full page at the specified width
- `--scale 2` produces a 2× retina-quality image
- Useful for sharing reports or single-page HTML as images

## Dependencies

| Package | Purpose | Install |
|---------|---------|---------|
| `playwright` | Headless browser screenshots | `pip install playwright` |
| `python-pptx` | Assemble screenshots into PPTX | `pip install python-pptx` |

No browser download needed if Chrome, Edge, or Brave is already installed.

## Works with any HTML

Designed to work with output from:
- **kai-slide-creator** — HTML presentations with `.slide` elements
- **kai-report-creator** — Single-page HTML reports
- Any self-contained HTML file

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

kai-html-export

Directory Structure

SKILL.md

Report

Notice