mdgate converters

ZIP to Markdown in your browser.

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

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

Starting local converter

Use ZIP to Markdown in your app

$ npm install @mdgate/zip 

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

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

  1. ZIP
  2. archive listing
  3. members · nested converters
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Open ZIP archives directly inside Workers without unzip or a native binary.

Browser

Inspect ZIP files locally without uploading them to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/zip extracts

  • Member names as Markdown when used alone
  • Each member handed back to the same converter registry inside create()
  • Nested archives and attachments converted by the matching format package
  • Encrypted member detection

Why @mdgate/zip

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

ZIP files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same ZIP file produces repeatable Markdown without model inference.

Small runtime surface

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

ZIP for AI agents

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

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

Need more than ZIP?

One format

@mdgate/zip

Your own set

@mdgate/core
+ @mdgate/zip
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert ZIP to Markdown without uploading it?

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

Does ZIP to Markdown work in Cloudflare Workers?

Yes. @mdgate/zip 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 ZIP converter?

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

Does it steal Office or EPUB files?

No. Office, ODF, EPUB, and iWork packages are also ZIP files. Those converters win on sniff score.