How do I convert HTML to EPUB with Pandoc?

Install Pandoc from pandoc.org, then run: pandoc input.html -o output.epub. Add metadata with --metadata title="My Book" --metadata author="Jane Smith". For multiple HTML chapters: pandoc ch1.html ch2.html ch3.html -o book.epub. Pandoc produces EPUB 3 with a generated table of contents from your heading structure. Free, works on Windows, Mac, and Linux.

Can Calibre convert HTML to EPUB?

Yes. Open Calibre, click Add books → select your .html file. Right-click → Convert books → Convert individually → set Output format to EPUB → OK. Calibre works well for single-file HTML documents. For multi-file HTML projects or websites, Pandoc is more reliable. Both tools are free.

How do I convert a web page to EPUB for offline reading?

Use Pandoc: pandoc https://example.com/article -o article.epub (Pandoc can fetch a URL directly). Or save the web page as HTML (File → Save Page As in your browser), then run pandoc saved-page.html -o article.epub. Remove navigation and sidebar HTML before converting for a clean EPUB. Alternatively, Calibre can import a URL via Book Details → Edit metadata → Download cover/metadata.

What is the difference between HTML and EPUB?

EPUB is essentially HTML packaged in a ZIP container (.epub) with a manifest (OPF file), navigation document (NAV), and optional CSS. EPUB 3 uses HTML5 and CSS3 directly — the same technologies as the web. The difference is packaging: EPUB bundles all assets into a single file with reading-order metadata, making it self-contained for e-reader distribution.

How to Convert HTML to EPUB — Pandoc, Calibre, and Online Tools (2026)

HTML is the native format of the web — and EPUB is just HTML packaged in a zip container. Converting HTML to EPUB is one of the cleanest ebook conversions you can make: your headings, paragraphs, links, and images all translate directly. Here are three free methods.

Why Convert HTML to EPUB?

Offline reading: Package a long web article, documentation, or web book as an EPUB for reading on a Kindle, Kobo, or phone app without an internet connection.
Publishing: Convert your HTML manuscript or static site to a distributable EPUB for KDP, Smashwords, or Apple Books.
Documentation: Convert technical docs (generated from MkDocs, Sphinx, or Jekyll) to EPUB for distribution to readers who prefer e-readers.

Method 1: Pandoc (Best, Command Line)

Pandoc is the gold-standard document converter. It produces clean EPUB 3 output from HTML with proper semantic structure.

# Install Pandoc (once): pandoc.org/installing.html
# Single HTML file to EPUB:
pandoc input.html -o output.epub

# With title and author metadata:
pandoc input.html -o output.epub --metadata title="My Book" --metadata author="Jane Smith"

# Multiple HTML chapters into one EPUB:
pandoc chapter1.html chapter2.html chapter3.html -o book.epub --metadata title="My Book"

# From a URL (downloads and converts the page):
pandoc https://example.com/article -o article.epub

Result: A valid EPUB 3 file with a generated table of contents, proper heading structure, and embedded images. Pandoc is free, runs on Windows/Mac/Linux, and handles complex HTML reliably.

Method 2: Calibre (GUI, No Command Line)

Download Calibre from calibre-ebook.com (free).
Click Add books → select your .html file.
Right-click → Convert books → Convert individually.
Set Output format to EPUB. Click OK.

Calibre works well for single-file HTML documents. For multi-file HTML projects (like a complete website), Pandoc or the command-line approach is more reliable.

Method 3: Online Converters

Zamzar and Convertio convert HTML files to EPUB in a browser — upload your .html, select EPUB output, download the result. Free tiers work for single files up to 25 MB. Your file is uploaded to their server, so avoid sensitive content.

Converting a Multi-Page Website to EPUB

For converting an entire website or multi-page documentation to EPUB, the typical workflow is:

Use wget or HTTrack to download the full site as HTML files.
Run Pandoc across all the HTML files in the correct reading order.
Or use a tool like Sigil to assemble the HTML files manually into an EPUB package.

Tips for Clean HTML-to-EPUB Conversion

Clean your HTML first: Remove navigation menus, headers, footers, and sidebars before converting — they'll appear as unwanted content in the EPUB.
Use semantic headings: <h1> through <h6> in your HTML map directly to the EPUB table of contents. Pandoc builds the TOC automatically from these.
Inline CSS only: Complex stylesheets may not render correctly in all EPUB readers. Pandoc's default EPUB CSS is clean and reader-friendly.
Check image paths: Relative image paths in your HTML should resolve correctly from the folder where you run Pandoc.

Coming From a PDF Instead?

If your original content is a PDF (not HTML), convert it to EPUB directly at toolkit.bot/pdf2epub — free, 15–60 seconds, no install. The PDF→EPUB conversion handles multi-column layouts, tables, and scanned documents that Pandoc cannot process.

Have a PDF you want to read on any e-reader? Convert to EPUB in seconds — free, no install required.

Convert PDF to EPUB →