mdgate converters

VSDX to Markdown in your browser.

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

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

Starting local converter

Use VSDX to Markdown in your app

$ npm install @mdgate/visio 

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

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

  1. VSDX
  2. shape text parsing
  3. pages · shapes · labels
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

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

Browser

Convert VSDX locally without uploading it to a server.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/visio extracts

  • Readable text from VSDX ZIP packages
  • Readable text from binary VSD OLE files
  • Shape and page text, not a visual render of the diagram

Why @mdgate/visio

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

VSDX files can stay inside your application or browser.

Content detection

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

Deterministic parsing

The same VSDX file produces repeatable Markdown without model inference.

Small runtime surface

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

VSDX for AI agents

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

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

Need more than VSDX?

One format

@mdgate/visio

Your own set

@mdgate/core
+ @mdgate/visio
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert VSDX to Markdown without uploading it?

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

Does VSDX to Markdown work in Cloudflare Workers?

Yes. @mdgate/visio 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 VSDX converter?

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

Does it render the diagram?

No. It extracts readable text from shapes and pages.