Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

preview markdown documents in the browser from vim

branch: master

This branch is 0 commits ahead and 0 commits behind master

Moved styles into their own css file.

It's a bit of a phaff to find the path to the CSS file. The method I'm
using works when the markdown-preview plugin is loaded with
Pathogen.vim, but I'm not sure if it will work if the plugin is loaded
the traditional way.
latest commit 98844ac2d2
Drew Neil authored September 17, 2010
Octocat-spinner-32 plugin Moved styles into their own css file. September 17, 2010
Octocat-spinner-32 screenshots Add screenshot. July 30, 2010
Octocat-spinner-32 LEGAL.mkd Add LEGAL mumbo jumbo. June 28, 2010
Octocat-spinner-32 README.mkd Add install procedures to README July 01, 2010
Octocat-spinner-32 Remove an older version of vim-markdown-preview if it exists when exe… June 28, 2010


vim-markdown-preview adds the option to preview markdown documents in the browser from the vim editor.
The web page it opens is loosely styled on how GitHub would render README.mkd.



  • Option 1
    Cloning this repository is one option, and the master branch should always be in a working state.

  • Option 2
    You can download versioned releases from the downloads page.

Automatic installation
vim-markdown-preview is bundled with an installer script which will install to $HOME/.vim/plugin/



Send vim the command :Mm for a preview of your markdown document.
Alternatively, bind :Mm to a key binding: map <leader>p :Mm<CR>


  • vim
  • Ruby support for vim.
  • kramdown (bundled with this package)


vim-markdown-preview was written to run on OSX, and it will work w/o problems.
I recommend the safari browser because it will not open new tabs needlessly if a document is already loaded in an existing tab/window.


vim-markdown-preview is tied to the OSX command open.
You will need to replace it with something else - firefox-bin, for example, for it to work on your operating system.


  • Mathias Billman
    This is an enitrely rewritten version of the vim script originally written by Mathias Billman and found here.

  • moreweb

  • maba


No known bugs right now. Found a bug?.


  • IRC as 'robgleeson'

  • Mail
    rob [at]

Something went wrong with that request. Please try again.