README.md

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
• Usage
  • Adding toc to all files in a directory and sub directories
  • Adding toc to a single file
    • Example
  • Using doctoc to generate bitbucket compatible links

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