HTML to PDF Conversion

Convert HTML files and web pages to professional PDF documents using Puppeteer.

Quick Start

CLI Usage

node scripts/html-to-pdf.js input.html output.pdf
node scripts/html-to-pdf.js input.html output.pdf A4
node scripts/html-to-pdf.js https://example.com output.pdf A4

Programmatic Usage

const convertHtmlToPdf = require('./scripts/html-to-pdf.js');

// Simple conversion
await convertHtmlToPdf('input.html', 'output.pdf');

// With options
await convertHtmlToPdf('input.html', 'output.pdf', {
  format: 'Letter',
  landscape: true,
  margin: { top: '20mm', bottom: '20mm' }
});

Features

• ✅ Convert local HTML files
• ✅ Convert web URLs (http/https)
• ✅ Customizable page formats (A4, Letter, etc.)
• ✅ Custom margins and spacing
• ✅ Landscape/portrait modes
• ✅ Print backgrounds
• ✅ Headers and footers
• ✅ Page ranges
• ✅ Zoom scaling

Common Options

Advanced Usage

With Headers and Footers

await convertHtmlToPdf('page.html', 'output.pdf', {
  displayHeaderFooter: true,
  headerTemplate: '\x3Cdiv>Page \x3Cspan class="pageNumber">\x3C/span>\x3C/div>',
  footerTemplate: '\x3Cdiv>© 2024\x3C/div>',
  margin: { top: '40px', bottom: '40px' }
});

Specific Page Ranges

await convertHtmlToPdf('document.html', 'pages-1-5.pdf', {
  pageRanges: '1-5'
});

Installation

Requires Node.js and npm:

npm install puppeteer

Reference

For complete API documentation and all available options, see api.md.