mdgate converters

GRAPHQL to Markdown in your browser.

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

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

Starting local converter

Use GRAPHQL to Markdown in your app

$ npm install @mdgate/text 

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

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

  1. GRAPHQL
  2. plain-text handling
  3. paragraphs · Markdown · code fences
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Normalize text files directly inside Workers without a second parser.

Browser

Convert GRAPHQL locally without uploading it to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/text extracts

  • .txt / .text: paragraphs
  • .md / .markdown / .mdx: passed through as Markdown
  • Source extensions: wrapped in a fenced code block

Why @mdgate/text

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

GRAPHQL files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same GRAPHQL file produces repeatable Markdown without model inference.

Small runtime surface

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

GRAPHQL for AI agents

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

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

Need more than GRAPHQL?

One format

@mdgate/text

Your own set

@mdgate/core
+ @mdgate/text
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert GRAPHQL to Markdown without uploading it?

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

Does GRAPHQL to Markdown work in Cloudflare Workers?

Yes. @mdgate/text 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 GRAPHQL converter?

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

Why pass a path?

The path selects treatment (paragraphs, pass-through Markdown, or a code fence). It is never used to read a file from disk.