mdx2apple

Dictionary, Redefined.

Convert MDict dictionaries to native macOS Dictionary.app format. One command. Beautiful results.

Get Started View Source

Automated Pipeline

One command to convert, compile, and install. Handles the entire workflow from MDX to Dictionary.app.

HTML Cleanup

Removes complex MDict-specific markup and simplifies HTML for proper rendering in Dictionary.app.

CSS Optimization

Fixes critical display issues like display:block and ensures proper CSS rendering in Dictionary.app.

Resource Handling

Copies audio files, images, and other assets correctly into the final .dictionary bundle.

Ready to convert?

terminal — -zsh — 80x24
$ git clone https://github.com/nxxxsooo/mdx2apple.git
$ cd mdx2apple
$ pip install pyglossary lxml beautifulsoup4 html5lib
$ python mdx2apple.py dictionary.mdx --install

Requires macOS and Python 3.8+