MOBI/AZW3 → Markdown/DOCX

What is MOBI/AZW3?

Mobipocket (.mobi) was long the default format Amazon accepted for Kindle delivery. AZW3 (also called KF8) is its successor with fuller HTML5/CSS support, and .azw is an earlier Amazon container. All three reflow and carry navigation and metadata, so they behave as one family. They are proprietary to Amazon's ecosystem, and since 2022 Amazon sends KFX/EPUB instead, so .mobi is mostly a legacy format now.

What is Markdown/DOCX?

Markdown (.md) and Word documents (.docx) are grouped here because they play the same role in conversion: lightweight structured authoring sources. Markdown is plain text plus markers (# headings, ** bold) — clean but limited. A .docx is a ZIP of Office Open XML with far richer layout (pagination, headers, footers, comments, tracked changes). Both are good conversion sources rather than final reading formats.

What to watch out for when converting MOBI/AZW3 to Markdown/DOCX

Extracting from the source

.mobi/.azw3 are proprietary Amazon binary containers with no official parsing spec; third-party tools rely on reverse engineering and occasionally fail or drop metadata. AZW3 stores HTML internally, so extracting text is easier than preserving layout.

Writing the target format

Producing .docx suits further editing, but reading is not its goal: pagination shifts with Word versions and fonts, and phone rendering is fragile. If the destination is an e-reader, EPUB is the right endpoint.

Where the two formats interact

• The source carries real navigation while the target has no concept of chapters, so reading becomes one long scroll. If navigation still matters, keep explicit, uniformly formatted chapter heading lines in the output.
• The source is a proprietary binary container and the target is an archive with a mandated directory structure. This is not unpack-and-repack: a real parse and rebuild must happen in between, so use a mature tool — hand-rolling it almost always yields a file no reader accepts.

Post-conversion checklist

1. Convert the first three chapters as a trial and check for lost text, interleaved lines or misplaced blocks before doing the whole book.
2. Jump to five random spots and search a character name to confirm the text is fully searchable.
3. Confirm illustration count and placement — check that images are not all dumped at the end of a chapter.
4. Fill in title, author and language — a wrong language tag breaks typesetting such as Chinese line breaking.

Converting novels: what is different

Fiction is the most common and the most peculiar kind of e-book: hundreds or thousands of chapters, almost no figures, often nothing but a TXT source, and Chinese sources that frequently carry anti-piracy garbling. These are the points that bite hardest.

• A long novel can run to hundreds or thousands of chapters, so the table of contents decides whether the result is usable. Normalise chapter headings to one recognisable pattern first — say "Chapter N Title" alone on its own line — or the target will miss chapters, merge them, or collapse the whole book into one.
• Volume markers ("Volume One", "Volume Two") usually degrade to ordinary headings, losing the volume/chapter hierarchy. If that matters, promote volume headings one level in an editor afterwards so they are not siblings of chapter titles.

Tools for converting MOBI/AZW3 to Markdown/DOCX

Any of the tools below can handle this direction; pick one by your operating system and how many files you have. Read the previous section first — doing the steps out of order (converting a scanned file before running OCR, for instance) usually means starting over.

Common questions

Related conversions