mdgate converters

YAML to Markdown in your browser.

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

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

Starting local converter

Use YAML to Markdown in your app

$ npm install @mdgate/data 

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

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

  1. YAML
  2. structured-data parsing
  3. objects · arrays · nested text
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Parse JSON, JSONL, YAML, and XML directly inside Workers.

Browser

Convert YAML locally without uploading it to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/data extracts

  • JSON objects and arrays as nested Markdown structure
  • JSONL as one record after another
  • YAML mappings and sequences
  • XML as nested headings and text

Why @mdgate/data

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

YAML files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same YAML file produces repeatable Markdown without model inference.

Small runtime surface

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

YAML for AI agents

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

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

Need more than YAML?

One format

@mdgate/data

Your own set

@mdgate/core
+ @mdgate/data
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert YAML to Markdown without uploading it?

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

Does YAML to Markdown work in Cloudflare Workers?

Yes. @mdgate/data 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 YAML converter?

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

Does XML need a path hint?

Yes when composed with other converters. Flat ODF and many office parts start with <?xml, so XML needs a .xml path hint.