Skip to content

An easy way to generate a table of contents for your markdown file

License

Notifications You must be signed in to change notification settings

ajorgensen/vim-markdown-toc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

markdown-toc.vim

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

Usage

  • 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

Configuration

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

Example

# 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

Installation

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'

About

An easy way to generate a table of contents for your markdown file

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published