mdgate converters

MP3 to Markdown in your browser.

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

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

Starting local converter

Use MP3 to Markdown in your app

$ npm install @mdgate/audio 

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

const toMarkdown = create([
  audio(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 MP3 to Markdown works

  1. MP3
  2. audio detection
  3. your transcription 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 audio inside Workers, then call the transcription function you register.

Browser

Files stay in the browser. Transcription still needs the callback your application provides.

Edge

Run the same TypeScript converter in compatible Edge runtimes.

What @mdgate/audio extracts

  • MP3, WAV, M4A, AAC, Ogg, FLAC, and WebM audio detection
  • The whole file passed to your transcription callback
  • No decode or resample inside mdgate

Detection vs Transcription

Detection

audio bytes → @mdgate/audio

Transcription

your speech model → Markdown

@mdgate/audio does not silently send audio to a transcription service.

Why @mdgate/audio

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 MP3 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.

MP3 for AI agents

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

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

Need more than MP3?

One format

@mdgate/audio

Your own set

@mdgate/core
+ @mdgate/audio
+ @mdgate/pdf
+ @mdgate/docx

Broad file support

@mdgate/converters

FAQ

Can I convert MP3 to Markdown without uploading it?

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

Does MP3 to Markdown work in Cloudflare Workers?

Yes. @mdgate/audio 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 MP3 converter?

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

Does it transcribe audio in the browser demo?

No. audio() is not in all(). Connect the speech model your application already uses.