mdgate converters

iBooks to Markdown in your browser.

Convert iBooks files to GitHub-Flavored Markdown directly in your browser.

Your iBooks stays on your device. No upload. No account.

Starting local converter

Use iBooks 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 iBooks to Markdown works

  1. iBooks
  2. package and spine parsing
  3. chapters · headings · links
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

Read local files, uploads, S3/R2 objects, and other byte sources.

Cloudflare Workers

Parse EPUB files directly inside Workers without an ebook reader or native binary.

Browser

Convert iBooks 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

iBooks files can stay inside your application or browser.

Content detection

Recognizes iBooks files from their contents, not only the filename.

Deterministic parsing

The same iBooks file produces repeatable Markdown without model inference.

Small runtime surface

No Python. No native addons. No WASM. No third-party runtime dependencies.

iBooks for AI agents

Turn iBooks files into content your agent can actually work with.

  1. iBooks
  2. Markdown
    • grep
    • search
    • chunk
    • index
    • cache
    • cite
    • reason

Need more than iBooks?

One format

@mdgate/epub

Your own set

@mdgate/core
+ @mdgate/epub
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert iBooks to Markdown without uploading it?

Yes. iBooks files can be converted locally in the browser.

Does iBooks 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 iBooks converter?

Yes. Install @mdgate/epub instead of the complete converter set.