A self-contained macOS app for converting documents (PDF, Word, PowerPoint, Excel, images, audio, HTML, CSV, and more) to Markdown, powered by Microsoft's MarkItDown.
Drag multiple files into a native window, preview each result, copy to the clipboard, or
save .md / a .zip via native Save dialogs. The app runs entirely on-device: no server,
no network port — Python and the page communicate through pywebview's JS↔Python bridge.
Grab the latest MarkItDown.zip from the Releases page, unzip it, and
move MarkItDown.app to your Applications folder.
First launch — important. This app is not yet notarized by Apple, so macOS will block it the first time with a message like "MarkItDown can't be opened because Apple cannot check it for malicious software." This is expected for unsigned apps downloaded from the internet. To open it, do one of these:
- Right-click (or Control-click)
MarkItDown.app→ Open → Open in the dialog. You only need to do this once.- Or run in Terminal:
xattr -dr com.apple.quarantine /Applications/MarkItDown.appAfter that, it opens normally like any other app.
Requires uv and macOS.
./build_app.shProduces dist/MarkItDown.app (self-contained, bundles Python; ~215 MB). Double-click to
launch.
./run.shThis creates a venv (Python 3.12 via uv), installs dependencies, and opens the native
window without packaging.
To distribute a build that opens cleanly for everyone, sign and notarize it with your own Apple Developer account ($99/yr):
export DEVELOPER_ID="Developer ID Application: Your Name (TEAMID)"
export APPLE_ID="you@example.com"
export TEAM_ID="XXXXXXXXXX"
export APP_PASSWORD="abcd-efgh-ijkl-mnop" # app-specific password
./notarize.shThen upload the resulting dist/MarkItDown.zip to a Release.
source .venv/bin/activate
python -m pytest tests/ -vsrc/markitdown_web/converter.py— pureconvert_bytes(filename, data)calling MarkItDown.src/markitdown_web/desktop.py— the pywebviewApibridge (convert/copy/save_markdown/save_all_zip) and the native-window launcher.src/markitdown_web/static/index.html— the drag-drop UI, talking to Python over the bridge.app_launcher.py+markitdown_web.spec— PyInstaller entry point and bundle config.
MIT — see LICENSE. Document conversion is performed by MarkItDown (also MIT, © Microsoft Corporation), installed from PyPI.