Skip to content

Complete User Guide: HTML to PDF Conversion

Master the art of converting HTML documents to professional PDF files. This comprehensive guide covers everything from basic usage to advanced techniques for perfect PDF generation.

1. Getting Started

Our HTML to PDF converter is designed to be intuitive and easy to use. Before you begin, here's what you need to know:

✓ What You Need

  • • A modern web browser
  • • Your HTML content (code or file)
  • • That's it!

✓ No Requirements

  • • No account needed
  • • No software installation
  • • No file uploads to servers

2. Step-by-Step Conversion

1

Enter Your HTML

You have two options to input your HTML content:

  • Paste: Copy your HTML code and paste it directly into the editor
  • Upload: Click the "Upload HTML" button to select an .html file from your computer
2

Preview Your Document

Click the "Preview" button to see how your HTML will render. The preview panel shows a live representation of your document. This helps you catch any issues before generating the PDF.

3

Configure Settings

Customize your PDF output:

  • Filename: Set the name for your downloaded PDF file
  • Orientation: Choose between Portrait or Landscape
  • Quality: Select Normal, High, or Very High quality
4

Generate & Download

Click the "Download PDF" button. The conversion happens instantly in your browser, and your PDF will automatically download to your device.

3. HTML Basics for PDF

A well-structured HTML document produces the best PDF output. Here's a recommended structure:

<!DOCTYPE html>
<html>
<head>
    <title>My Document</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            margin: 20px;
            line-height: 1.6;
        }
        h1 { color: #333; }
        p { margin-bottom: 1em; }
    </style>
</head>
<body>
    <h1>Document Title</h1>
    <p>Your content goes here...</p>
</body>
</html>

Pro Tip

Always include a complete HTML document with proper DOCTYPE, html, head, and body tags for the most consistent results.

4. CSS Styling Tips

Supported CSS Properties

Most common CSS properties work well:

✓ Fully Supported:
  • • font-family, font-size, font-weight
  • • color, background-color
  • • margin, padding, border
  • • text-align, line-height
  • • width, height (fixed values)
⚠ Limited Support:
  • • CSS Grid layouts
  • • Complex Flexbox
  • • CSS animations
  • • @media queries
  • • @import rules

/* Example CSS for print-friendly output */

body {
    font-family: 'Georgia', serif;
    font-size: 12pt;
    line-height: 1.5;
    color: #000;
    background: #fff;
}

h1, h2, h3 {
    margin-top: 1em;
    margin-bottom: 0.5em;
}

table {
    border-collapse: collapse;
    width: 100%;
}

td, th {
    border: 1px solid #333;
    padding: 8px;
}

5. Working with Images

Important

External image URLs will NOT work because our converter runs entirely in your browser and cannot fetch resources from other websites for security reasons.

To include images, you must embed them as Base64 data URLs:

<!-- Base64 embedded image -->
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." 
     alt="My Image" 
     style="max-width: 100%;" />

How to Convert Images to Base64

  1. Use an online Base64 encoder (search "image to base64")
  2. Upload your image to get the Base64 string
  3. Replace the src attribute with the data URL
  4. Include the proper MIME type (image/png, image/jpeg, etc.)

6. Creating Tables

HTML tables are well-supported and render nicely in PDFs:

<table>
    <thead>
        <tr>
            <th>Header 1</th>
            <th>Header 2</th>
            <th>Header 3</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Row 1, Cell 1</td>
            <td>Row 1, Cell 2</td>
            <td>Row 1, Cell 3</td>
        </tr>
        <tr>
            <td>Row 2, Cell 1</td>
            <td>Row 2, Cell 2</td>
            <td>Row 2, Cell 3</td>
        </tr>
    </tbody>
</table>

Table Tips

  • • Use thead for headers that repeat on each page
  • • Add border-collapse: collapse for cleaner borders
  • • Set explicit widths for consistent column sizing

7. Page Layout Control

Manual Page Breaks

Insert page breaks where you want a new page to begin:

<!-- Insert a page break -->
<div class="html2pdf__page-break"></div>

<!-- Content after this will start on a new page -->

Prevent Element Breaking

Keep elements together across pages:

/* Prevent element from being split across pages */
.keep-together {
    break-inside: avoid;
    page-break-inside: avoid;
}

8. Best Practices

✓ Do

  • • Use complete HTML documents
  • • Include all styles inline or in head
  • • Embed images as Base64
  • • Test with preview before generating
  • • Use print-friendly fonts
  • • Set explicit dimensions

✗ Don't

  • • Use external image URLs
  • • Link to external CSS files
  • • Include JavaScript
  • • Use complex animations
  • • Rely on @media queries
  • • Use web fonts without embedding

9. Troubleshooting

PDF is blank or mostly empty

Solution: Ensure your HTML has visible content with proper styling. Check that colors have sufficient contrast (avoid white text on white background).

Images not appearing

Solution: Convert images to Base64 data URLs. External image URLs cannot be fetched by the browser-based converter.

Conversion is slow

Solution: Reduce document complexity, use Normal quality, optimize images, and close unnecessary browser tabs.

Layout looks wrong

Solution: Simplify CSS, avoid complex flexbox/grid layouts, use fixed pixel widths instead of percentages for critical elements.

Ready to create your PDF?

Start Converting HTML to PDF

Ready to Convert?

Now that you know how to create perfect PDFs, try it yourself!