mdgate converters

GIF to Markdown in your browser.

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

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

Starting local converter

Use GIF to Markdown in your app

$ npm install @mdgate/image 

// Register the callback your app already uses
import { create } from '@mdgate/core';
import { image } from '@mdgate/image';

const toMarkdown = create([
  image(yourCallback),
]);

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

  1. GIF
  2. image detection
  3. SVG text · your vision callback
  4. GitHub-Flavored Markdown

Built for JavaScript runtimes

Node.js

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

Cloudflare Workers

Detect images inside Workers. SVG converts locally. Raster images use the callback you register.

Browser

Convert SVG locally. Raster images need a vision callback in your application.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/image extracts

  • SVG / SVGZ titles and visible text
  • JPEG, PNG, WebP, GIF, TIFF, HEIC, and BMP via your callback

SVG vs Raster image

SVG

SVG text → @mdgate/image → Markdown

Raster image

JPEG / PNG / … → your vision pipeline

@mdgate/image does not silently send images to an OCR or AI service.

Why @mdgate/image

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

Detection stays local. Model work happens only through a callback you register.

Content detection

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

Deterministic parsing

Format detection is deterministic. Any model output comes from the callback you supply.

Small runtime surface

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

GIF for AI agents

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

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

Need more than GIF?

One format

@mdgate/image

Your own set

@mdgate/core
+ @mdgate/image
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert GIF to Markdown without uploading it?

Files you drop on this page stay in the browser. GIF conversion that needs a model still requires a callback in your application.

Does GIF to Markdown work in Cloudflare Workers?

Yes. @mdgate/image 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 GIF converter?

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

Does it OCR scanned images?

Not by itself. Raster formats need a vision callback you provide. SVG converts locally.