Markdown Anything

Convert files to clean, structured Markdown using the Markdown Anything API. Supports PDF, DOCX, XLSX, PPTX, images, audio, and 25+ formats.

Setup

Set your API token as an environment variable. Get one from Settings > API Tokens in your Markdown Anything workspace.

CODEBLOCK0

When to Use

Use the mda-convert tool when the user asks to:

• - Convert a file to Markdown
• Extract text from a PDF, document, image, or audio file
• Turn a document into Markdown for use in a prompt or workflow

Tools

mda-convert

Converts a file to Markdown. Run scripts/convert.sh with the file path as the first argument.

Arguments:

• - $1 — Path to the file to convert

Optional environment variables:

• - MDA_ENHANCED_AI=true — Use Enhanced AI for scanned documents, images, and audio (costs extra credits)
• INLINECODE4 — Include document metadata in the response
• INLINECODE5 — Optimize output for LLM token efficiency

Example:
CODEBLOCK1

The tool outputs the converted Markdown to stdout.

mda-credits

Check your remaining credit balance. Run scripts/credits.sh with no arguments.

Example:
CODEBLOCK2

Security & Privacy

• - Files are sent to https://markdownanything.com/api/v1/convert for processing
• Your API token is sent via the Authorization header
• No data is stored locally beyond the conversion result
• See Markdown Anything Privacy Policy for data handling details