Skip to main content
skill CX Codex

html-to-pdf · yonggao — Claude Code skill: what it does, how to install

html-to-pdf converts HTML files into multi-page A4 PDFs or continuous PNG screenshots. Useful for printing web reports and exporting presentations without page breaks.

MIT 1 installs ★ 2 updated 2025-12-27

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add yonggao/claude-plugins --skill html-to-pdf -a claude-code
Open on GitHub

What html-to-pdf does

This skill coordinates document export through three specialized Python scripts. The html_to_pdf_final.py script renders standard multi-page A4 files with zero margins while preserving colors and backgrounds. When standard page cuts interrupt content, html_to_long_image.py captures a full-length PNG screenshot and embeds it into a single-page PDF.

For layouts with complex stylesheets, html_to_pdf_converter.py attempts conversion via WeasyPrint first and falls back to Playwright. The automation logic scrolls through pages to trigger lazy-loaded images and stops CSS transitions before rendering.

Execution fails when browser binaries are missing, which makes running playwright install chromium mandatory alongside the playwright, pillow, and pypdf packages.

What it helps with

  • export HTML reports to multi-page A4 PDF files
  • generate full-page PNG screenshots of web content
  • create presentation PDFs without visible page breaks
  • render HTML documents with lazy-loaded media

Example prompts for the agent

  • Convert report.html into a multi-page A4 PDF for printing
  • Take a full-page PNG screenshot of dashboard.html and export it as a one-page PDF
  • Run the fallback converter on overview.html to generate output.pdf

How to install html-to-pdf

1Skills CLI (Vercel)

npx skills add yonggao/claude-plugins --skill html-to-pdf -a claude-code

2Manually: put the files in place

~/.claude/skills/html-to-pdf/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/html-to-pdf/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about html-to-pdf

How to install html-to-pdf in Claude Code?

Run npx skills add yonggao/claude-plugins --skill html-to-pdf -a claude-code in your terminal.

What is the difference between standard PDF and the long image method?

Standard conversion splits content into traditional A4 pages. The long image method creates a full-height PNG screenshot first, then wraps it into an unbroken single-page PDF.

How do you fix Playwright browser missing errors?

Download the required browser build by running playwright install chromium.

Source text

SKILL.md · MIT
---
name: html-to-pdf
description: Converts HTML files to PDF or PNG format. Use this skill when the user asks to convert, export, or generate PDF/PNG from HTML files, or when they want to create printable documents, presentations, or long-form images from web pages or HTML reports.
---

# HTML to PDF/PNG Converter Skill

This skill helps you convert HTML files to PDF or PNG format with various options for output quality and page layout.

## When to Use This Skill

Use this skill when the user wants to:
- Convert HTML files to PDF
- Generate PNG screenshots from HTML
- Create printable documents from web pages
- Export HTML reports as PDFs
- Generate long-form images without page breaks
- Create presentation-ready PDFs from HTML

## Available Conversion Methods

### Method 1: Multi-Page PDF (Standard A4)
Best for: Printing, archiving, traditional documents

**Command:**
```bash
python html_to_pdf_final.py input.html output.pdf
```

**Features:**
- Standard A4 page format
- Zero margins for seamless appearance
- Background colors and gradients preserved
- Multiple pages with page breaks
- Optimized file size (~5-6 MB for typical reports)

### Method 2: Single-Page Long Image PDF
Best for: Online viewing, presentations, no page breaks

**Command:**
```bash
python html_to_long_image.py input.html
```

**Features:**
- Generates a full-page PNG screenshot first
- Converts PNG to single-page PDF
- NO page breaks - entire content on one page
- Perfect for presentations and online viewing
- Smaller file size (~1-2 MB)
- Two output files: `.png` and `.pdf`

### Method 3: Advanced Multi-Method Converter
Best for: Fallback options, compatibility

**Command:**
```bash
python html_to_pdf_converter.py input.html output.pdf
```

**Features:**
- Tries WeasyPrint first (best CSS support)
- Falls back to Playwright if needed
- Automatic dependency installation
- Handles complex CSS and gradients

## Required Dependencies

The skill requires Playwright and Pillow. The scripts auto-install dependencies if missing:

```bash
pip install playwright pillow pypdf
playwright install chromium
```

## Step-by-Step Instructions

### For Standard Multi-Page PDF:

1. **Verify the HTML file exists:**
   ```bash
   ls -la *.html
   ```

2. **Run the converter:**
   ```bash
   python html_to_pdf_final.py your_file.html
   ```

3. **Open the result:**
   ```bash
   open your_file_final.pdf
   ```

### For Single-Page Long Image PDF:

1. **Verify the HTML file exists:**
   ```bash
   ls -la *.html
   ```

2. **Run the long image converter:**
   ```bash
   python html_to_long_image.py your_file.html
   ```

3. **Check outputs:**
   ```bash
   # View the PNG screenshot
   open your_file_fullpage.png

   # View the PDF version
   open your_file_fullpage.pdf
   ```

## Troubleshooting

### Issue: Playwright browser not found

**Solution:**
```bash
playwright install chromium
```

### Issue: Page breaks visible in PDF

**Solution:** Use the long image method instead:
```bash
python html_to_long_image.py your_file.html
```

### Issue: Content appears cut off

**Causes & Solutions:**
- **CSS animations not complete**: Script waits 2 seconds for animations
- **Lazy loading**: Script scrolls through entire page to trigger loading
- **Large file size**: Scripts handle files up to 20MB+

### Issue: Blank PDF output

**Solution:** Use the long image method which uses screenshot instead of PDF rendering:
```bash
python html_to_long_image.py your_file.html
```

## Output Files

After conversion, you'll get:

**Multi-Page PDF:**
- `filename_final.pdf` - Standard A4 multi-page PDF

**Long Image Method:**
- `filename_fullpage.png` - Complete screenshot as PNG (6-10 MB)
- `filename_fullpage.pdf` - Single-page PDF from image (1-2 MB)

## Best Practices

1. **For online viewing/presentations:** Use `html_to_long_image.py`
   - No page breaks
   - Smooth scrolling experience
   - Smaller file size

2. **For printing/archiving:** Use `html_to_pdf_final.py`
   - Standard A4 pages
   - Better for physical printing
   - Professional document format

3. **For complex CSS:** Use `html_to_pdf_converter.py`
   - Multiple fallback methods
   - Better compatibility

## Implementation Notes

### Script Locations
All scripts should be in the project directory:
- `html_to_pdf_final.py` - Main multi-page converter
- `html_to_long_image.py` - Long image generator
- `html_to_pdf_converter.py` - Advanced multi-method converter

### Key Features Implemented

1. **Animation Handling**: All scripts disable CSS animations/transitions
2. **Lazy Loading**: Scripts scroll through content to trigger loading
3. **Background Preservation**: All gradients and colors render correctly
4. **Zero Margins**: Seamless page appearance without visible borders
5. **Chinese Font Support**: Handles CJK characters properly

## Examples

### Example 1: Convert BP Report to Multi-Page PDF
```bash
python html_to_pdf_final.py 202510_Alpha_Intelligence_BP.html
# Output: 202510_Alpha_Intelligence_BP_final.pdf (22 pages, 5.7 MB)
```

### Example 2: Create Single-Page Presentation PDF
```bash
python html_to_long_image.py 202510_Alpha_Intelligence_BP.html
# Output:
#   - 202510_Alpha_Intelligence_BP_fullpage.png (6.1 MB)
#   - 202510_Alpha_Intelligence_BP_fullpage.pdf (1.6 MB, 1 page)
```

### Example 3: Batch Convert Multiple Files
```bash
for file in *.html; do
    python html_to_long_image.py "$file"
done
```

## Advanced Usage

### Custom Output Paths
```bash
python html_to_pdf_final.py input.html custom_output.pdf
python html_to_long_image.py input.html
```

### Check PDF Page Count
```bash
python -c "from pypdf import PdfReader; r = PdfReader('output.pdf'); print(f'Pages: {len(r.pages)}')"
```

### Verify File Sizes
```bash
ls -lh *.pdf *.png
```

## Performance Expectations

- **Processing Speed**: ~5-10 seconds for typical HTML files
- **Memory Usage**: ~100-200 MB during conversion
- **PDF File Size**: 1-6 MB depending on method
- **PNG File Size**: 6-10 MB for full-page screenshots

## Success Criteria

A successful conversion should:
1. ✅ Generate PDF/PNG without errors
2. ✅ Include all HTML content (no truncation)
3. ✅ Preserve colors, gradients, and styling
4. ✅ Handle Chinese/CJK characters correctly
5. ✅ Create readable file sizes (< 10 MB)

## Quick Reference

| Need | Use | Output |
|------|-----|--------|
| Printing | `html_to_pdf_final.py` | Multi-page A4 PDF |
| Online viewing | `html_to_long_image.py` | Single-page PDF + PNG |
| Maximum compatibility | `html_to_pdf_converter.py` | Multi-page PDF with fallbacks |

© yonggao · MIT · yonggao/claude-plugins

Similar skills

All skills for Writing and docs →

html-to-pdf by other authors comes first.

html-to-pdf aviz85 html-to-pdf renders HTML files, URLs, and piped markup into PDF documents using headless Chrome with built-in right-to-left language handling. CX Codex +1 1,300installs pdf-to-html daymade pdf-to-html turns a PDF into one self-contained HTML file that keeps images, tables and reading order. Handy when you want to read a report on your phone instead of scrolling pages. CX Codex +1 529installs kimi-pdf thvroyal kimi-pdf — a skill that turns HTML into PDF with Paged.js, compiles LaTeX, and works with existing files: extract text, merge, split, fill forms. CX Codex +1 428installs pdf-creator daymade pdf-creator turns Markdown into print-ready or mobile-friendly PDFs with themes and Chinese typography support. It also runs a visual check on the generated document. CX Codex +1 1,100installs kami-document-design reason-machines kami-document-design — a skill that locks generated resumes, slides, letters and white papers into one editorial look. Useful when you want a clean PDF without hand-building the layout. CX Codex +1 394installs mcp-document-converter xt765 mcp-document-converter is an MCP server for Claude Code, Codex and Cursor that converts documents between Markdown, HTML, DOCX, PDF and Text for context injection in the session. CX Codex +1 ★ 12repo stars cc-design-html-prototyping reason-machines The cc-design-html-prototyping skill builds HTML mockups, slide decks, and interactive prototypes. Use it to explore visual directions before implementing an interface. CX Codex +1 430installs

Project sponsors

Companies that keep this analytics open