Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Convert enex to Markdown.

Project description

enex2md

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!

Features

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:

  • [x] Strong and emphasis text styles.
  • [x] Ordered (i.e. numbered) and unordered lists
  • [x] Tables created within Evernote are converted to GFM Tables
  • [x] Tasks are converted to GFM Task list items
  • [x] Images and other attachments
  • [x] Code blocks
  • [x] 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.

Installation

Installing to a virtual environment is strongly recommended. To install, 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.

Project details


Download files

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

Files for enex2md, version 0.4.2
Filename, size File type Python version Upload date Hashes
Filename, size enex2md-0.4.2-py3-none-any.whl (8.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size enex2md-0.4.2.tar.gz (9.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page