An easy way to generate a table of contents for your markdown file
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.


Have you ever wanted to have a sweet table of contents for your markdown file but didn't want to deal with the pain of generating it yourself? Well now you dont have to.

  1. Usage
  2. Configuration
  3. Example
  4. Installation


  • Run :GenerateMarkdownTOC to generate the table of contents for an open markdown file. This will place the generated table of contents at the location of your cursor at the time that you run the command.
    • Supports both # and ==/-- styles of header declarations


By default this plugin will not generate an entry for top level headers (# or ==). You can modifying this behavior by setting g:mdtoc_starting_header_level = 1

let g:mdtoc_starting_header_level = 1


# Top level header

1. [Sub-heading](#sub-heading)
2. [Another sub heading](#another-sub-heading)
	1. [You can even mix heading styles if that floats your boat](#you-can-even-mix-heading-styles-if-that-floats-your-boat)
		1. [This is totally like inception](#this-is-totally-like-inception)

## Sub-heading
Some content will go here

Another sub heading
Some other content can go here if you want

### You can even mix heading styles if that floats your boat
Because we know you do what you want

#### This is totally like inception


You can use your favorite vim package manage but here are a few for your convenience.

" plug.vim
Plug 'ajorgensen/vim-markdown-toc'

" Vundle
Plugin 'ajorgensen/vim-markdown-toc'