Sublime Text 2 Plugin for the Pandoc Markdown Renderer
Latest commit 5e01de3 Feb 25, 2013 @jclement Merge pull request #11 from zyxar/master
fix pandoc searching in env.path
Failed to load latest commit information.
.gitignore added git ignore Feb 12, 2012
Default (OSX).sublime-keymap add pandoc path settings support. Feb 25, 2013
Default (Windows).sublime-keymap Default Keymap Feb 12, 2012
Main.sublime-menu add pandoc path settings support. Feb 25, 2013
Pandoc.sublime-settings add pandoc path settings support. Feb 25, 2013 fixes link to pandoc Aug 2, 2012
package-metadata.json Initial Feb 11, 2012
reference.docx added git ignore Feb 12, 2012
template.html Added menu items and hopefully have it loading docx files on all plat… Feb 12, 2012

Pandoc Plugin for Sublime Text 2

A Sublime Text 2 plugin for calling the Pandoc Markdown renderer to create HTML and DocX output. Pandoc does a LOT more than this but this is the specific functionality I use.


The easiest way is to install "SublimePandoc" using Package Control.

You can also grab the latest from Github and install it into your Sublime Text 2 Packages folder.

$ git clone git://


You'll need to download and install Pandoc and have it in your PATH.

Available Commands

pandoc_render will render the markdown to HTML or DOCx and takes the following optional arguments:

  • writeBeside - When set will output the rendered result in the same folder, and with the same name as the source file. This requires that the buffer has already been saved and has a filename. Defaults to FALSE.
  • openAfter - When set will open the resulting document after rendering it. Defaults to FALSE.
  • target - Can be either 'html' or 'docx'. Defaults to 'html'.
  • additionalArguments - A list of additional arguments to pass to Pandoc.

Menu items for common tasks should show up under Tools > Pandoc.

Output Hints

The following hints can be added in your document to flip on additional features in Pandoc. (Note: these hints are processed by the plugin and NOT part of Pandoc itself)

<!-- [[TOC]] -->: Add a Table of Contents to the top of your output document.

<!-- [[NUM]] -->: Turn on numbering of sections.


"template.html" controls the output of the HTML documents and "reference.docx" is used for style definitions for DOCX output.

Note: If you are using a pre-built binary of Pandoc you will be unable to customize the reference.docx using Microsoft Word in versions <= 1.9.1

Sample Keybindings

The default keymapping on Windows...

  { "keys": ["ctrl+alt+r"],     
    "args":{"openAfter":true,   "target":"html",  "writeBeside":false},
    "context":[{"key": "selector", "operator": "equal", "operand": "text.html.markdown" }]},

  { "keys": ["ctrl+alt+shift+d"],   
    "args":{"openAfter":true,   "target":"docx",  "writeBeside":true},
    "context":[{"key": "selector", "operator": "equal", "operand": "text.html.markdown" }]},

  { "keys": ["ctrl+alt+shift+r"],   
    "args":{"openAfter":false,  "target":"html",  "writeBeside":true},
    "context":[{"key": "selector", "operator": "equal", "operand": "text.html.markdown" }]}