html-to-pdf

SKILL.md

Pixel-perfect HTML to PDF conversion with automatic RTL and Hebrew language support.

Renders using Chrome headless engine with full CSS3/HTML5 support, including Flexbox, Grid, custom fonts, and JavaScript execution

Automatic right-to-left direction detection for Hebrew, Arabic, and other RTL languages; includes --rtl flag for forced RTL mode

Configurable page formats (A4, Letter, Legal, A3, A5), orientation, margins, scale, and optional headers/footers

Requires one-time npm setup; includes critical guidance on fitting single-page content and verification workflow to prevent overflow and cut-off text

HTML to PDF Converter

Pixel-perfect HTML to PDF conversion using Puppeteer (Chrome headless). Provides excellent support for Hebrew, Arabic, and other RTL languages with automatic direction detection.

Why Puppeteer?

Pixel-perfect rendering: Uses actual Chrome engine

Full CSS3/HTML5 support: Flexbox, Grid, custom fonts, backgrounds

JavaScript execution: Renders dynamic content

Automatic RTL detection: Detects Hebrew/Arabic and sets direction

Web font support: Loads custom fonts properly

Auto-Fit (Built-in, No Flag Needed)

The script automatically handles content overflow:

Small overflow (up to ~18%) → auto-shrinks font size to fit the page

Large content → flows cleanly across multiple pages with smart page-break rules (no cutting headers, table rows, or images in half)

Fits perfectly → does nothing