DocToc
Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated
by github or bitbucket via a command line flag.
Table of Contents generated with DocToc
Installation
npm install -g doctoc
Usage
Adding toc to all files in a directory and sub directories
Go into the directory that contains you local git project and type:
doctoc .
This will update all markdown files in the current directory and all its
subdirectories with a table of content that will point at the anchors generated
by the github markdown parser.
Adding toc to a single file
If you want to convert only a specific file, do:
doctoc /path/to/file
Example
doctoc README.md
Using doctoc to generate bitbucket compatible links
In order to add a table of contents whose links are compatible with anchors generated by
bitbucket, supply a --bitbucket
flag to doctoc.
doctoc README.md --bitbucket