Skip to main content

Convert enex to Markdown.

Project description


version platform wheel downloads license

Enex2md is a command-line utility to convert Evernote export files (*.enex) to GitHub Flavored Markdown. Python 3.6+ only!


In addition to the note content itself, the note metadata is included in the resulting Markdown. The enex-bundle may contain one or more notes.

Within the note content, the following features are supported:

  • Strong and emphasis text styles.
  • Ordered (i.e. numbered) and unordered lists
  • Tables created within Evernote are converted to GFM Tables
  • Tasks are converted to GFM Task list items
  • Images and other attachments
  • Code blocks
  • Subsequent empty lines are compressed to one.

The html in enex files is somewhat interesting, thus some magic is used to massage the data to functioning feature-rich Markdown. The Magic Book used here has not yet been fully written, so there might be some unfortunate side effects. Should you find one, open an issue on GitHub with a well written description and a test enex file as an attachment.

See Changelog for more details.


Installing to a virtual environment is strongly recommended. To install, run:

pip install -U enex2md


To use the CLI after installing, run the conversion with:

enex2md [enex-file-to-process]

The output is written to STDOUT by default. If you want to write to disk instead, add a flag --disk to the command. This option will create a directory based on run time timestamp, and place individual files under that.

Please note, that on STDOUT output option attachments (including images) are not processed!


Clone the repository to your local machine.

I strongly recommend using a virtual environment for development.

Install the requirements with:

pip install -r requirements.txt

From the root of the repository, you can run the app with:

python -m enex2md.cli foo.enex

After editing the content, try to install the package locally with:

python install

See that everything works. You can uninstall the dev package with pip uninstall enex2md.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

enex2md-0.4.2.tar.gz (9.0 kB view hashes)

Uploaded source

Built Distribution

enex2md-0.4.2-py3-none-any.whl (8.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page