enex2md 0.2.0

Convert enex to Markdown.

enex2md

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

Features

In addition to the content itself, the note metadata is included in the resulting Markdown.

Within the content, the following features are supported:

• Strong and emphasis text styles.
• Lists
• Tables created within Evernote are converted to GFM Tables.
• Tasks are converted to GFM Task list items
• 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. Since the Magic Book has not yet been fully written, there are a couple of known issues:

• Attachments are not handled at the moment.
• Images are lost (technically they are attachments in enex).
• Codeblocks are not handled correctly.

This is work in progress, but should already generate useful results.

See Changelog for more details.

Installation

Preferably in a virtual environment, run:

pip install -U enex2md

Usage

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!

Development

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 setup.py install

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