mdgate converters

IPYNB to Markdown in your browser.

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

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

Starting local converter

Use IPYNB to Markdown in your app

$ npm install @mdgate/ipynb 

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

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

  1. IPYNB
  2. nbformat parsing
  3. markdown cells · code cells · outputs
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Parse notebooks directly inside Workers without Jupyter or a Python kernel.

Browser

Convert IPYNB locally without uploading it to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/ipynb extracts

  • Markdown cells as Markdown
  • Code cells as fenced code blocks
  • Cell outputs that can be represented as text
  • Cell order

Why @mdgate/ipynb

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

IPYNB files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same IPYNB file produces repeatable Markdown without model inference.

Small runtime surface

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

IPYNB for AI agents

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

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

Need more than IPYNB?

One format

@mdgate/ipynb

Your own set

@mdgate/core
+ @mdgate/ipynb
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert IPYNB to Markdown without uploading it?

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

Does IPYNB to Markdown work in Cloudflare Workers?

Yes. @mdgate/ipynb 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 IPYNB converter?

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