mdgate converters

ONETOC2 to Markdown in your browser.

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

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

Starting local converter

Use ONETOC2 to Markdown in your app

$ npm install @mdgate/onenote 

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

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

  1. ONETOC2
  2. OneNote stream parsing
  3. page titles · body lines
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Parse OneNote files directly inside Workers without OneNote or a native binary.

Browser

Convert ONETOC2 locally without uploading it to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/onenote extracts

  • Page titles when they can be recognized
  • Readable body lines from OLE streams or packed bytes
  • .onepkg ZIP members passed back through the same reader when composed with create()

Why @mdgate/onenote

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

ONETOC2 files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same ONETOC2 file produces repeatable Markdown without model inference.

Small runtime surface

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

ONETOC2 for AI agents

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

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

Need more than ONETOC2?

One format

@mdgate/onenote

Your own set

@mdgate/core
+ @mdgate/onenote
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert ONETOC2 to Markdown without uploading it?

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

Does ONETOC2 to Markdown work in Cloudflare Workers?

Yes. @mdgate/onenote 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 ONETOC2 converter?

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

Does it reconstruct ink and layout?

No. This is best-effort text extraction, not a full OneNote renderer.