mdgate converters

MBOX to Markdown in your browser.

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

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

Starting local converter

Use MBOX to Markdown in your app

$ npm install @mdgate/email 

import { toMarkdown } from '@mdgate/email';

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 MBOX to Markdown works

  1. MBOX
  2. MIME / MSG parsing
  3. headers · body · attachments
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Parse MBOX files directly inside Workers without an email client.

Browser

Convert MBOX files locally without uploading them to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/email extracts

  • Subject as a heading
  • From, To, Cc, and Date
  • HTML bodies converted through the HTML document model
  • Plain-text bodies
  • Attachment names under an Attachments heading
  • Outlook .msg compound files

Why @mdgate/email

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

MBOX files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same MBOX file produces repeatable Markdown without model inference.

Small runtime surface

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

MBOX for AI agents

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

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

Need more than MBOX?

One format

@mdgate/email

Your own set

@mdgate/core
+ @mdgate/email
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert MBOX to Markdown without uploading it?

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

Does MBOX to Markdown work in Cloudflare Workers?

Yes. @mdgate/email 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 MBOX converter?

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