html-to-pdf

name	html-to-pdf
description	Convert HTML to PDF using the fulgur CLI (npx @fulgur-rs/cli). Generates HTML from a description if no file is provided.

HTML to PDF

Use this skill when the user wants to convert an HTML file to PDF, or wants to create a PDF document from scratch.

Workflow

Step 1 — Determine the HTML source

• If the user provides an HTML file path, use it directly.
• If no HTML is provided, ask for the document's purpose and content, then generate the HTML and save it to a temporary file (e.g. output.html).

When generating HTML, produce clean, print-ready markup:

• Use inline styles or a <style> block — no external stylesheets unless the user provides one.
• Set appropriate page dimensions via CSS (@page { size: A4; margin: 20mm; }).
• Use web-safe fonts or note that custom fonts can be bundled with -f.

Step 2 — Determine conversion options

Infer from context or ask if unclear:

Option	Flag	Default
Page size	-s A4 | Letter | A3	A4
Landscape	-l	portrait
Margin (mm)	--margin "top right bottom left"	browser default
Font file	-f path/to/font.ttf	none
Extra CSS	--css path/to/style.css	none
Image	-i name=path/to/image.png	none
JSON data	-d path/to/data.json	none

Step 3 — Run the conversion

npx @fulgur-rs/cli render -o <output>.pdf [options] <input>.html

Examples:

# Basic
npx @fulgur-rs/cli render -o output.pdf input.html

# A4 landscape with custom margin
npx @fulgur-rs/cli render -o output.pdf -s A4 -l --margin "15 20" input.html

# Japanese font
npx @fulgur-rs/cli render -o output.pdf -f NotoSansJP.ttf input.html

# Template with JSON data
npx @fulgur-rs/cli render -o invoice.pdf -d data.json template.html

Step 4 — Report completion

Tell the user where the PDF was saved. If the conversion fails, show the error output and suggest fixes (missing font, malformed HTML, etc.).