DEV Community

KindleReady
KindleReady

Posted on Originally published at ziliao.de5.net

Your Word Manuscript Is Not an EPUB: 5 Structural Mistakes That Break Every Conversion

Every week, authors finish a book, run their .docx through a converter, and get back an EPUB with an empty table of contents, missing images, or chapters that refuse to split. The converter usually gets the blame. In most cases the file was broken before conversion started — because a Word document stores appearance, and an EPUB needs structure.

Here are the five structural mistakes I see over and over, and how to fix each in minutes.

1. Chapter titles that are just big bold text

This is the big one. If your chapter titles are 18pt bold text typed by hand, every converter sees them as ordinary paragraphs. No headings → no chapter splits → no table of contents.

Fix: Select each chapter title and apply Word's built-in Heading 1 style. Converters build the EPUB's navigation from Heading 1s. This single change fixes the majority of "my TOC is empty" reports.

2. Manual page breaks and empty paragraphs for spacing

Ebooks reflow — there is no fixed page. Page breaks and stacks of empty paragraphs that looked fine in Word turn into random blank screens and weird gaps on a Kindle.

Fix: Delete manual page breaks and empty paragraphs. Control spacing with paragraph styles (space before/after) instead.

3. Linked images instead of embedded images

If Word is linking to image files rather than embedding them, the images simply aren't inside the .docx — and can't be inside the EPUB either.

Fix: Re-insert images so they're embedded (Insert → Pictures, not "Link to File"), and keep them inline with text. Floating images and text boxes don't survive conversion at all.

4. Copy-paste encoding damage

Text pasted between apps often carries smart-quote and encoding damage that shows up as ’ instead of ' inside the ebook.

Fix: When pasting from another app, paste as plain text and reapply the formatting in Word.

5. Skipping validation because "it opened fine"

An EPUB can open in one reader and still be rejected by Kindle, Apple Books, or Kobo — each store validates structure strictly. The classic failure is a vague store error message that tells you nothing about what to fix.

Fix: Run every EPUB through a validator before uploading anywhere, and fix what it reports while the manuscript is still fresh in your head. A good validation report explains each error in plain language instead of raw EPUBCheck codes.

The 30-minute pipeline

Once the structure is clean, the rest is quick:

  1. Prepare (15 min) — Heading 1s, remove manual breaks, embed images.
  2. Convert (2 min) — DOCX → EPUB 3, with chapters and TOC generated from your headings.
  3. Validate (5 min) — fix anything the validator flags.
  4. Metadata + cover (10 min) — stores read your title, author, and description from the file's metadata; a missing cover is the most common rookie mistake.

I built KindleReady to cover steps 2–4 in the browser for free — converter, a validator that explains errors in plain English, and a metadata editor — because the existing options were either Mac-only, expensive, or assumed you enjoy reading XML error codes. If you already have a workflow with Calibre or Sigil, the five fixes above still apply; they're about the manuscript, not the tool.

Structure first. The conversion is the easy part.

Top comments (0)