Node.js
Read local files, uploads, S3/R2 objects, and other byte sources.
EPUB to Markdown in your browser.
Convert EPUB files to GitHub-Flavored Markdown directly in your browser.
Your EPUB stays on your device. No upload. No account.
- npm @mdgate/epub
- license MIT
- runtime Node.js · Edge · browser
Starting local converter
Use EPUB to Markdown in your app
$
npm install @mdgate/epub
import { toMarkdown } from '@mdgate/epub';
const markdown = await toMarkdown(bytes);Pure TypeScript, Node.js, Cloudflare Workers, Edge, Browser, No Python, No native addons, No WASM, Zero third-party runtime dependencies
How EPUB to Markdown works
- EPUB
- package and spine parsing
- chapters · headings · links
- GitHub-Flavored Markdown
Built for JavaScript runtimes
Cloudflare Workers
Parse EPUB files directly inside Workers without an ebook reader or native binary.
Browser
Convert EPUB locally without uploading it to a server.
Edge
Run the same TypeScript converter in compatible Edge runtimes.
What @mdgate/epub extracts
- Spine order
- Chapter HTML as Markdown
- Headings, paragraphs, lists, links, and tables
- iBooks packages that use the same ZIP + HTML shape
Why @mdgate/epub
Runs where your JavaScript runs
No separate processing service. The converter is TypeScript you can call from Node.js, Cloudflare Workers, Edge runtimes, and browsers.
Local conversion
EPUB files can stay inside your application or browser.
Content detection
Recognizes EPUB files from their contents, not only the filename.
Deterministic parsing
The same EPUB file produces repeatable Markdown without model inference.
Small runtime surface
No Python. No native addons. No WASM. No third-party runtime dependencies.
EPUB for AI agents
Turn EPUB files into content your agent can actually work with.
- EPUB
- Markdown
-
- grep
- search
- chunk
- index
- cache
- cite
- reason
Need more than EPUB?
One format
@mdgate/epub
Your own set
@mdgate/core
+ @mdgate/epub
+ @mdgate/pdf
+ @mdgate/docx
Broad file support
@mdgate/converters
FAQ
Can I convert EPUB to Markdown without uploading it?
Yes. EPUB files can be converted locally in the browser.
Does EPUB to Markdown work in Cloudflare Workers?
Yes. @mdgate/epub runs directly in Cloudflare Workers.
Does it require Python?
No.
Does it require native addons or WASM?
No.
What does it output?
GitHub-Flavored Markdown.
Can I install only the EPUB converter?
Yes. Install @mdgate/epub instead of the complete converter set.