Inspect the archive
The route validates the EPUB signature and blocks traversal paths, encrypted entries, excessive compression, unsafe entry counts, and oversized expanded content before persistent processing.
Use this ebook to Markdown workflow to keep chapter order, headings, links, and portable images for AI, RAG, knowledge bases, or editing.
The archive is checked before storage and extraction. Markovo limits entry count, paths, compression ratio, and total expanded size.
EPUB is a packaged website with a reading order, navigation, XHTML chapters, styles, metadata, and local assets. Markovo extracts the parts that can remain portable without executing scripts or fetching remote content.
The route validates the EPUB signature and blocks traversal paths, encrypted entries, excessive compression, unsafe entry counts, and oversized expanded content before persistent processing.
Readable chapters follow the package spine rather than raw ZIP filename order. Headings, paragraphs, lists, links, emphasis, and simple tables become Markdown.
Supported local images are moved into assets/, references are rewritten, and metadata, source mapping, quality evidence, a manifest, and the ZIP stay together.
Markdown preserves readable content, not every behavior of an ebook reader. Use the original EPUB when typography, pagination, interactive widgets, media overlays, or exact navigation behavior matters.
Compare chapter names and sequence with the source. Front matter, appendices, notes, split chapters, and nested navigation can need adjustment before a RAG pipeline or publishing migration.
Copying only output.md can leave relative image links behind. Download the complete bundle when covers, figures, diagrams, or other local images must remain available.
DRM-protected, encrypted, malformed, empty, or oversized archives are not converted. The route does not remove access controls, execute embedded scripts, or import remote pages referenced by the book.
Review the book at chapter boundaries before downstream use. Remove duplicated running text only when it is clearly packaging noise, keep front matter when it affects authorship or rights, and preserve notes when they qualify the surrounding argument. For retrieval, chunk within real sections instead of merging unrelated chapters. Keep chapter names and source mapping when an answer must point back to the ebook. For publishing migrations, verify emphasis, lists, tables, code, internal links, images, captions, and notes against the source. An EPUB may include accessibility metadata, alternate text, reading hints, or layout behavior that plain Markdown cannot reproduce. Rights and access restrictions remain the user's responsibility; conversion does not grant permission to redistribute a book.
Keep the original EPUB for pagination, typography, accessibility behavior, navigation, and any multimedia context that a Markdown projection cannot carry. Review it before publishing.