Sublime Text 2 Plugin for the Pandoc Markdown Renderer
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
Default (OSX).sublime-keymap
Default (Windows).sublime-keymap

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" }]}