✦  Built on Microsoft MarkItDown

Turn anything into
Markdown.

Drop your files. Paste a URL. Walk away with clean, structured Markdown — no terminal required.

Download View Source
Queue view Conversion in progress Results view
Everything you need.
Nothing you don't.
A complete conversion workflow — from drag-and-drop intake to polished Markdown export.

Drag & Drop Queue

Drag files directly into the queue, add entire folders (top-level), or paste website URLs. Batch processing handles dozens of documents in one session.

🔄

Real-Time Progress

Elapsed timer, per-document page counter, and a visual progress bar keep you informed. Pause, resume, or cancel at any time — including in-flight HTTP requests.

👁️

Live Preview

Toggle between rendered Markdown and raw source. Select individual files from results, copy output, or export as one combined file or separate files.

🌐

URL → Markdown

Paste any web URL and convert article content to Markdown via the Defuddle API. Responses include YAML frontmatter metadata when available.

🔍

Triple OCR Engine

Three OCR paths to handle any document: Azure Document Intelligence, local Tesseract, or OpenAI-compatible vision endpoints like LM Studio.

🎨

Perfect Dark Theme

Four theme modes including the custom Perfect Dark palette with refined nav and title chrome, plus a centered content column on ultrawide displays.

Built on a great foundation.
Pushed further.
Markdown Alchemy is a fork of markitdown-gui by Jonas, with deeper UX polish and expanded capabilities.

Live Progress Dashboard

Elapsed time, document count, and per-document page counter update in real time during conversion.

OpenAI-Compatible Vision OCR

Point the app at any OpenAI-style vision endpoint for rasterized PDFs and images. Optional "always OCR" toggle for stubborn scans.

True Cancellation

Cancel tears down in-flight HTTP requests where applicable, with clearer progress feedback across PDF and model operations.

Add Folder & Extended i18n

Import top-level files from a directory with filter support. English and Chinese strings cover every new UI element.

Up and running
in 60 seconds.
Grab a prebuilt binary or run from source with two commands.

⚡ Quick Start (uv)

Recommended. Requires Python 3.10+ and uv.
uv sync
uv run python -m markitdowngui.main

📦 Alternative (pip)

Works with any standard Python environment.
pip install -e .[dev]
python -m markitdowngui.main

🏗️ Build Standalone

Create a distributable executable.
uv pip install -e .[dev]
pyinstaller MarkItDown.spec --clean --noconfirm
📥

Or Just Download

Prebuilt binaries when available.
View Releases →
Three engines.
Every document covered.
OCR is optional and disabled by default. Enable the engine that fits your workflow.
🔷

Azure Document Intelligence

Cloud-powered OCR with 500 free pages/month. Set your endpoint in Settings and the AZURE_OCR_API_KEY env var.

Tesseract (Local)

Fully offline. Install the Tesseract binary and set its path in Settings if it's not on your system PATH.

🧠

OpenAI-Compatible Vision

Point at LM Studio or any OpenAI-style endpoint. Configure base URL, model, and prompt directly in-app. Optional "always OCR" for difficult PDFs.

Hands on the keys.
Eyes on the Markdown.
ShortcutAction
Ctrl + OOpen files
Ctrl + SSave output
Ctrl + CCopy output
Ctrl + BStart conversion
Ctrl + PPause / Resume
Ctrl + LClear queue
Ctrl + KShow shortcuts
EscCancel conversion