# Vim Markdown runtime files

This is the development version of Vim's included syntax highlighting and
filetype plugins for Markdown.  Generally you don't need to install these if
you are running a recent version of Vim.

One difference between this repository and the upstream files in Vim is that
the former forces `*.md` as Markdown, while the latter detects it as Modula-2,
with an exception for `README.md`.  If you'd like to force Markdown without
installing from this repository, add the following to your vimrc:

    autocmd BufNewFile,BufReadPost *.md set filetype=markdown

To enable fenced code block syntax highlighting in your markdown
documents, add the following to your `.vimrc`:

    let g:markdown_fenced_languages = ['html', 'python', 'bash=sh']

**Note**: The fenced language names must be valid names of syntax files in vim's `syntax` folder. For example: `syntax/ruby.vim`.

To disable markdown syntax concealing, add the following to your `.vimrc`:

    let g:markdown_syntax_conceal = 0

Syntax highlighting is synchronized in 50 lines. This may cause collapsed
highlighting on large fenced code blocks.
In that case, set `g:markdown_minlines` to a larger value in your `.vimrc`:

    let g:markdown_minlines = 100

**Note**: Setting `g:markdown_minlines` to a value that is too large value may cause poor highlighting performance.

To enable folding, add the following to your `.vimrc`:

    let g:markdown_folding = 1

## License

Copyright © Tim Pope.  Distributed under the same terms as Vim itself.
See `:help license`.