📜 Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites.
Alternatives To Doctoc
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Blackfriday4,9875,3951,5337 months ago13October 27, 2020207otherGo
Blackfriday: a markdown processor for Go
Doctoc3,88910,1751,7663 months ago43September 22, 202257mitJavaScript
📜 Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites.
Vue Markdown1,3734581053 years ago13July 31, 201784mitJavaScript
A Powerful and Highspeed Markdown Parser for Vue
2 months ago17gpl-3.0C++
macOS Quick Look extension for Markdown files.
Gitdown4391,50291a year ago71March 01, 202218otherJavaScript
GitHub markdown preprocessor.
2 years ago6mitPython
SublimeText3 plugin which generate a table of contents (TOC) in a markdown document.
Github Slugger22910,3913735 months ago12October 27, 2022iscJavaScript
:octocat: Generate a slug just like GitHub does for markdown headings.
Markdown It Anchor2225,2722,628a month ago61December 18, 20223unlicenseJavaScript
A markdown-it plugin that adds an `id` attribute to headings and optionally permalinks.
Vue3 Markdown It18654 months ago17January 14, 202228mitJavaScript
✨ An awesome Vue 3 markdown-it wrapper plugin that can even support external plugins!
4 months ago1agpl-3.0JavaScript
a personal knowledge base system. markdown markup, runs in the browser
Alternatives To Doctoc
Select To Compare

Alternative Project Comparisons

DocToc Node.js CI

Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites via a command line flag.

Table of Contents generated with DocToc


npm install -g doctoc


In its simplest usage, you can pass one or more files or folders to the doctoc command. This will update the TOCs of each file specified as well as of each markdown file found by recursively searching each folder. Below are some examples.

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 markdown parser. Doctoc defaults to using the GitHub parser, but other modes can be specified.

Ignoring individual files

In order to ignore a specific file when running doctoc on an entire directory, just add <!-- DOCTOC SKIP --> to the top of the file you wish to ignore.

Update existing doctoc TOCs effortlessly

If you already have a TOC inserted by doctoc, it will automatically be updated by running the command (rather than inserting a duplicate toc). Doctoc locates the TOC by the <!-- START doctoc --> and <!-- END doctoc --> comments, so you can also move a generated TOC to any other portion of your document and it will be updated there.

Adding toc to individual files

If you want to convert only specific files, do:

doctoc /path/to/file [...]




Using doctoc to generate links compatible with other sites

In order to add a table of contents whose links are compatible other sites add the appropriate mode flag:

Available modes are:



doctoc --bitbucket

Specifying location of toc

By default, doctoc places the toc at the top of the file. You can indicate to have it placed elsewhere with the following format:

<!-- START doctoc -->
<!-- END doctoc -->

You place this code directly in your .md file. For example:

Here we are, introducing the post. It's going to be great!
But first: a TOC for easy reference.

<!-- START doctoc -->
<!-- END doctoc -->

# Section One

Here we'll discuss...

Running doctoc will insert the toc at that location.

Specifying a custom TOC title

Use the --title option to specify a (Markdown-formatted) custom TOC title; e.g., doctoc --title '**Contents**' . From then on, you can simply run doctoc <file> and doctoc will will keep the title you specified.

Alternatively, to blank out the title, use the --notitle option. This will simply remove the title from the TOC.

Specifying a maximum heading level for TOC entries

Use the --maxlevel option to limit TOC entries to headings only up to the specified level; e.g., doctoc --maxlevel 3 .

By default,

  • no limit is placed on Markdown-formatted headings,
  • whereas headings from embedded HTML are limited to 4 levels.

Printing to stdout

You can print to stdout by using the -s or --stdout option.

Only update existing ToC

Use --update-only or -u to only update the existing ToC. That is, the Markdown files without ToC will be left untouched. It is good if you want to use doctoc with lint-staged.

Usage as a git hook

doctoc can be used as a pre-commit hook by using the following configuration:

-   repo:
    rev: ...  # substitute a tagged version
    -   id: doctoc

This will run doctoc against markdown files when committing to ensure the TOC stays up-to-date.

Docker image

There's an unofficial Docker image project for doctoc, if you'd like to use doctoc via Docker or other container based CI/CD pipeline, you can take a look at PeterDaveHello/docker-doctoc

Popular Anchor Projects
Popular Markdown Projects
Popular User Interface Components Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.