Evernote for Sublime Text

Sublime Text plugin for Evernote.

This package is based on SublimeEvernote for ST2 but is only supported on ST3 and adds many new features.

Main Features

• Send a note to Evernote: converts the markdown document in the current view into rich text and sends it to your Evernote. You will be able to choose a title, tags and the notebook where to store it.
• Open a note from Evernote: shows panels to choose a note from a notebook, converts it to markdown and presents it in a view.
• Update note: when editing the markdown of an opened note you can save it back to Evernote (again in rich text).
• Full two-way metadata support: you can set and change the note's title, notebook and tag just by providing a YAML metadata header in your markdown source.

Installation

Clone this repository with

$ git clone http://github.com/bordaigorl/sublime-evernote.git

in

• Windows: %APPDATA%/Roaming/Sublime Text 3/Packages/
• OSX: ~/Library/Application Support/Sublime Text 3/Packages/
• Linux: ~/.Sublime Text 3/Packages/
• Portable Installation: Sublime Text 3/Data/

Usage

First use

When you first run this package from the command palette, it will launch a browser window with your Evernote developer token. Copy the token and paste it into the prompt at the bottom of your Sublime window. Sublime will store the token data in Sublime Text 3/Packages/User/SublimeEvernote.sublime-settings.

If you need to reconfigure the plugin go to Preferences > Package Settings > Evernote and select Reconfigure Authorisation or goto

Command Palette > Evernote: Reconfigure

PLEASE NOTE

The authentication method makes use of the Developer Token which is unique to your account and grants read-write access to your Evernote. This token will be saved in your user settings in the Evernote.sublime-settings so make sure you do not share this publicly!

Commands

Send to Evernote

Command Palette > Evernote: Send to Evernote

This will create a new note containing the HTML version of the markdown code of your active view. You will be able to specify the title, tags and notebook either from panels or with a metadata block (see below)

Open Note

Command Palette > Evernote: Open Evernote Note

This will open a panel from which you can select a notebook and a note in it. The selected note will be converted in markdown format and opened in a view. This command only handles the main contents of the note and ignores the attachments.

Update Note

Command Palette > Evernote: Update Evernote Note

or ctrl+s on views displaying an Evernote note.

When the current view is associated with an Evernote note (maybe because you just sent it to Evernote or because it is an opened note) you can update the note with this command. The metadata will be updated according to the metadata block and attachments stored in the original Evernote note will be left alone.

Metadata

A markdown source can start with a metadata block like the following:

---
title: My Note's Title
tags: misc, sublime
notebook: My Notebook 
---

When sending or updating the note, the plugin will extract this metadata and set/change it accordingly. When such header is incomplete or missing, when sending the note to Evernote the plugin will ask for input for the missing fields.

The tags field can be an unquoted list or a json list such as ["my long tag", "tag2"].

Settings

The Evernote.sublime-settings can be accessed from Preferences > Package Settings > Evernote.

The two settings token and noteStoreUrl are set by the plugin in the first use.

The following settings can be customised:

• inline_css: a dictionary associating some HTML element names to inline CSS styles; currently the only elements that can be styled in this way are: pre, code, h1, hr, blockquote and sup. Additionally footnotes can be associated to some style for the div containing the footnotes at the end of the note. The markdown of a note can contain (almost) arbitrary HTML blocks but Evernote only accepts a subset of the elements and attributes (class and id are disallowed). See here for details.
• code_highlighting_style: a pygments style among autumn, default, github, monokai, perldoc, vim, borland, emacs, igor, murphy, rrt, vs, bw, friendly, native, tango, xcode, colorful, fruity, manni, pastie, trac.
• code_friendly: if true the code-friendly extra of markdown2 is enabled
• notes_order: how to sort the notes in the panels; possible values: created, updated, relevance, update_sequence_number, title. Set the notes_order_ascending setting to true to reverse the selected order.
• max_notes: maximum number of notes in a panel; default is 100.

Acknowledgements

• Current maintainer and new features: @bordaigorl
• Original ST2 Plugin: jamiesun
• Port to ST3:
  • rekotan
  • timlockridge
• Other contributors: @mwcraig and @rayou.

Libraries (some adapted to work with Evernote formats):

• Markdown2 converter: trentm
• HTML2Markdown: Aaron Swartz
• Evernote API: https://github.com/evernote/evernote-sdk-python