mdgate converters

HWPX to Markdown in your browser.

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

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

Starting local converter

Use HWPX to Markdown in your app

$ npm install @mdgate/hwp

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

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

  1. HWPX
  2. HWP / HWPX parsing
  3. paragraphs · headings · tables
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Parse Hangul files directly inside Workers without Hangul Word Processor or a native binary.

Browser

Convert HWPX locally without uploading it to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/hwp extracts

  • HWPX / HWTX paragraphs and line breaks
  • Heading styles when present
  • Tables in HWPX
  • HWP 5 PARA_TEXT records when the layout is recognizable
  • Readable UTF-16 strings and PrvText preview as a fallback
  • Encrypted and distribution-locked document detection

Why @mdgate/hwp

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

HWPX files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same HWPX file produces repeatable Markdown without model inference.

Small runtime surface

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

HWPX for AI agents

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

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

Need more than HWPX?

One format

@mdgate/hwp

Your own set

@mdgate/core
+ @mdgate/hwp
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert HWPX to Markdown without uploading it?

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

Does HWPX to Markdown work in Cloudflare Workers?

Yes. @mdgate/hwp 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 HWPX converter?

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

Is binary HWP fully reconstructed?

No. The converter prefers structured text when it can find it, and falls back to extracted strings rather than pretending it has a full HWP renderer.