How do I install the HTML To PDF skill?

Run npx skillmds add yugasun/html-to-pdf in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is HTML To PDF safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with HTML To PDF?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is HTML To PDF free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published HTML To PDF?

yugasun (@yugasun) published this skill. Their other Agent Skills are listed on their SkillMD profile.

HTML To PDF by yugasun — Agent Skill

Name: HTML To PDF
Rating: 4.5 (4 reviews)
Author: yugasun

HTML To PDF

Export HTML files to PDF using Playwright with mobile emulation and custom viewport settings. Use this skill when the user asks to convert HTML to PDF, export presentations to PDF, or generate PDF documents from web pages.

yugasun e1685a3 2 files · 6.8 KB Updated Sep 10, 2026

File contents

HTML to PDF Export

Export HTML files (local or URLs) to PDF using Playwright with configurable viewport and mobile emulation.

Quick Start

Use the provided script to export HTML to PDF:

uv run {baseDir}/scripts/export_to_pdf.py input.html output.pdf

Export urls:

uv run {baseDir}/scripts/export_to_pdf.py https://example.com output.pdf

Key Features

Mobile Emulation: 768px viewport for mobile-optimized rendering
Background Printing: Preserves colors and backgrounds
Dynamic Content: Waits for JavaScript execution (ECharts, animations, etc.)
Full Page Capture: Auto-detects page height for complete output
Debug Mode: Visual inspection before PDF generation

Technical Details

Viewport Configuration

Width: 768px (matches CSS @media (max-width: 768px) breakpoint)
Height: 1024px initial, expands to full content
Device Scale: 2x for retina displays
Mobile Mode: Enabled to trigger mobile-specific behaviors

Rendering Pipeline

Load: Opens URL in Chromium browser with mobile viewport
Wait: Network idle + 10s buffer for JS execution
Measure: Calculates full page height via scrollHeight
Export: Generates PDF with exact dimensions
Cleanup: Closes browser and context

Wait Times

Default wait: 10 seconds after network idle

Adjust for heavy JS/animations:

# In export_to_pdf.py, modify:
page.wait_for_timeout(15000)  # 15 seconds

Dependencies

Install Playwright:

pip install playwright
playwright install chromium

Common Use Cases

Slide Decks: Export presentation HTML with animations and charts
Reports: Convert dynamic dashboards to static PDFs
Documentation: Generate PDF versions of web documentation
Newsletters: Archive HTML emails as PDFs

Troubleshooting

Missing Backgrounds

Already handled by injecting:

body {
    -webkit-print-color-adjust: exact !important;
    print-color-adjust: exact !important;
}

Content Cut Off

The script auto-detects page height. If issues persist:

Check if content is position: fixed/absolute
Verify viewport width triggers correct CSS breakpoints
Increase wait timeout for slow-loading content

Charts Not Rendering

Increase wait time in script:

page.wait_for_timeout(15000)  # or more

Script Reference

See scripts/export_to_pdf.py for the complete implementation. The script is self-contained and can be used directly from the command line or imported as a module.

---name: html-to-pdfdescription: Export HTML files to PDF using Playwright with mobile emulation and custom viewport settings. Use this skill when the user asks to convert HTML to PDF, export presentations to PDF, or generate PDF documents from web pages.---# HTML to PDF ExportExport HTML files (local or URLs) to PDF using Playwright with configurable viewport and mobile emulation.## Quick StartUse the provided script to export HTML to PDF:```bashuv run {baseDir}/scripts/export_to_pdf.py input.html output.pdf```Export urls:```bashuv run {baseDir}/scripts/export_to_pdf.py https://example.com output.pdf```## Key Features- **Mobile Emulation**: 768px viewport for mobile-optimized rendering- **Background Printing**: Preserves colors and backgrounds- **Dynamic Content**: Waits for JavaScript execution (ECharts, animations, etc.)- **Full Page Capture**: Auto-detects page height for complete output- **Debug Mode**: Visual inspection before PDF generation## Technical Details### Viewport Configuration- **Width**: 768px (matches CSS `@media (max-width: 768px)` breakpoint)- **Height**: 1024px initial, expands to full content- **Device Scale**: 2x for retina displays- **Mobile Mode**: Enabled to trigger mobile-specific behaviors### Rendering Pipeline1. **Load**: Opens URL in Chromium browser with mobile viewport2. **Wait**: Network idle + 10s buffer for JS execution3. **Measure**: Calculates full page height via `scrollHeight`4. **Export**: Generates PDF with exact dimensions5. **Cleanup**: Closes browser and context### Wait TimesDefault wait: **10 seconds** after network idleAdjust for heavy JS/animations:```python# In export_to_pdf.py, modify:page.wait_for_timeout(15000) # 15 seconds```## DependenciesInstall Playwright:```bashpip install playwrightplaywright install chromium```## Common Use Cases1. **Slide Decks**: Export presentation HTML with animations and charts2. **Reports**: Convert dynamic dashboards to static PDFs3. **Documentation**: Generate PDF versions of web documentation4. **Newsletters**: Archive HTML emails as PDFs## Troubleshooting### Missing BackgroundsAlready handled by injecting:```cssbody { -webkit-print-color-adjust: exact !important; print-color-adjust: exact !important;}```### Content Cut OffThe script auto-detects page height. If issues persist:- Check if content is position: fixed/absolute- Verify viewport width triggers correct CSS breakpoints- Increase wait timeout for slow-loading content### Charts Not RenderingIncrease wait time in script:```pythonpage.wait_for_timeout(15000) # or more```## Script ReferenceSee `scripts/export_to_pdf.py` for the complete implementation. The script is self-contained and can be used directly from the command line or imported as a module.

Frequently asked questions