Using Markdown With Evernote via Sublime Text: A (Forked) Package

Update 11/10/13: This package has been updated to include notebook selection and now requires Sublime Text 3. It might still work with Sublime 2, but if you have problems I would encourage you to try installing the package via Sublime 3 first.

The Overview

I’ve cobbled together a couple of packages and created a fork of the SublimeEvernote package for Sublime Text. If you want to send Markdown to Evernote (with Evernote rendering your Markdown as rich text), this is the tool for you.

The Context

I’ve been a loyal Textmate user for years, but last Spring, at the urging of several colleagues, I downloaded a copy of Sublime Text and studied up. In the time since, Sublime has become my primary composing environment. While I don’t know that I would suggest it as a go-to Markdown tool for general writers, I can say that–in terms of power and extendability–it is the best solution for anyone working with a number of different digital languages.

Part of that power comes via the Command Palette (an Alfred-like tool that allows you to launch features via a keystroke) and the many Sublime Text packages. There’s a solid Lynda overview of Sublime’s features, and it’s worth browsing if you’re interested.

I’ve been doing more writing in Evernote this week (as classes have started), and although I love Evernote as a place to archive and search through notes, it’s not a good composing space for me. It was time to search for a Markdown-to-Evernote Sublime package.

A quick look through Package Control revealed jamiesun’s SublimeEvernote package, which provides a way to send Markdown notes directly to Evernote from Sublime. Conceptually, I haven’t seen a simpler way to get Markdown into Evernote. Upon installing the plugin, however, I found that it uses an antiquated means of authenticating your Evernote account–so the package is broken.

Looking through the git forks, it seemed that rekotan had solved this problem, implementing a token-based authentication method in the package. I installed the package, and yes–it connects to Evernote. rekotan, however, also removed the markdown translation tools–so the Evernote notes aren’t parsed into rich text. Instead, the note is stored in Evernote as preformatted text (meaning that headings still have a # in front of them, and bold text is still shown with asterisks around it). I realize the value of this; however, when I send a note to Evernote, I don’t need the Markdown syntax intact. At that point the note can be archived as rich text.

So I combined the token-based authentication with the original project and created a new fork. Installation instructions follow. If you’re a Sublime user, this is a very simple means of pushing Markdown text into Evernote.

Installation Instructions

  1. Open Terminal.
  2. Navigate to your Sublime packages directory. For me, that command is: cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages
  3. Clone the repository: git clone --recursive
  4. Restart Sublime Text
  5. Write a note in Markdown
  6. Launch the Command Palette (Comamnd+Shift+P for Mac, or Ctrl+Shift+P for PC & Linux) type “Evernote” and choose “Send to Evernote” An image of the "Send to Evernote" option
  7. A new window will launch with your Developer Token. Copy it.
  8. Jump back to Sublime & paste the token into the entry box at the bottom of the Sublime window. The dialog box is easy to miss, but it will appear at the bottom of your Sublime window.
  9. The box at the bottom of Sublime will prompt for a title. Give the note one. It will then ask for tags (optional). An image of the title selection dialog box
  10. If everything works as expected, you will get a dialog box acknowledging success and the note should be in your default Evernote notebook! The Success Dialog Box

1. If you are git savvy, you can also clone the repo from the command line–and then get future updates via a pull request.

« Using TextExpander to Prep Evernote Essentials: @Inbox »