/vim-pandoc-syntax

pandoc markdown syntax, to be installed alongside vim-pandoc

Primary LanguageVim ScriptMIT LicenseMIT

vim-pandoc-syntax

Vint

Standalone pandoc syntax module, to be used alongside vim-pandoc.

Forked from the version provided by fmoralesc/vim-pantondoc, in turn taken from vim-pandoc/vim-pandoc.

Requirements

  • A vim version with +conceal
  • vim-pandoc, to set the pandoc filetype (otherwise you'll have to set it up yourself).

Installation

The repository follows the usual bundle structure, so it's easy to install it using pathogen, Vundle or NeoBundle.

For Vundle users, it should be enough to add

Plugin 'vim-pandoc/vim-pandoc-syntax'

to .vimrc, and then run :PluginInstall.

For those who need it, a tarball is available from here.

Standalone

If you want to use vim-pandoc-syntax without vim-pandoc, you'll need to tell Vim to load it for certain files. Just add something like this to your vimrc:

augroup pandoc_syntax
    au! BufNewFile,BufFilePre,BufRead *.md set filetype=markdown.pandoc
augroup END

For vimwiki users, use

augroup pandoc_syntax
  autocmd! FileType vimwiki set syntax=markdown.pandoc
augroup END

Features

  • Supports most (if not all) pandoc's markdown features, including tables, delimited codeblocks, references, etc.
  • Can handle multiple embedded languages (LaTeX, YAML headers, many languages in delimited codeblocks). Some commands are provided to help with this (see :help pandoc-syntax-commands)
  • Pretty display using conceal (optional).
  • Configurable (see :help pandoc-syntax-configuration for an overview of the options).

Screenshots

img1 img2 img3 img4