Skip to content

About

A self-contained macOS app for converting documents to Markdown, powered by Microsoft's MarkItDown.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

MarkItDown Mac App

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.

Download (just use the app)

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

After that, it opens normally like any other app.

Build it yourself

Requires uv and macOS.

./build_app.sh

Produces dist/MarkItDown.app (self-contained, bundles Python; ~215 MB). Double-click to launch.

Run in development

./run.sh

This creates a venv (Python 3.12 via uv), installs dependencies, and opens the native window without packaging.

Sign & notarize (optional, removes the Gatekeeper warning)

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

Then upload the resulting dist/MarkItDown.zip to a Release.

Tests

source .venv/bin/activate
python -m pytest tests/ -v

How it works

  • src/markitdown_web/converter.py — pure convert_bytes(filename, data) calling MarkItDown.
  • src/markitdown_web/desktop.py — the pywebview Api bridge (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.

License

MIT — see LICENSE. Document conversion is performed by MarkItDown (also MIT, © Microsoft Corporation), installed from PyPI.

About

A self-contained macOS app for converting documents to Markdown, powered by Microsoft's MarkItDown.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages