mdgate converters

DOCX to Markdown in your browser.

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

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

Starting local converter

Use DOCX to Markdown in your app

$ npm install @mdgate/docx 

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

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

  1. DOCX
  2. WordprocessingML parsing
  3. headings · lists · tables · notes
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Parse Word files directly inside Workers without a document service or native binary.

Browser

Convert DOCX locally without uploading it to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/docx extracts

  • Headings and paragraphs
  • Bold, italic, and strikethrough
  • Links
  • Ordered, unordered, and nested lists
  • Tables, including merged cells
  • Footnotes and endnotes
  • Field results
  • Charts and diagrams as readable blocks

Why @mdgate/docx

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

DOCX files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same DOCX file produces repeatable Markdown without model inference.

Small runtime surface

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

DOCX for AI agents

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

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

Need more than DOCX?

One format

@mdgate/docx

Your own set

@mdgate/core
+ @mdgate/docx
+ @mdgate/pdf
+ @mdgate/pptx

Broad file support

@mdgate/converters

FAQ

Can I convert DOCX to Markdown without uploading it?

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

Does DOCX to Markdown work in Cloudflare Workers?

Yes. @mdgate/docx 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 DOCX converter?

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