mdtoc.js
$ npm install -g mdtoc
mdtoc.js is a little Markdown filter that scans your document for headings, numbers them, adds anchors, and inserts a table of contents. It is a JavaScript port of Sam Stephenson's mdtoc.rb.
To use mdtoc, make sure that the headings you want numbered and linked are in this format:
### Title ###
Note that the headings must have an equal number of octothorpes around the title text (in Markdown, # means h1, ## means h2, and so on). The table of contents will be inserted before the first such heading.
lib/mdtoc.js exposes the mdtoc function, which accepts a string of Markdown source text as its only argument. It is compatible with web browsers, JavaScript engines, and CommonJS environments. The bin/mdtoc executable is Node-specific, and can be invoked like so:
$ mdtoc source.md
$ mdtoc first.md second.md | markdown
$ cat source.md | mdtoc
$ cat first.md | mdtoc second.md third.md | markdown
- Released into the public domain, 2012-04-08.
- Original Ruby version by Sam Stephenson.
- Ported to JavaScript by Kit Cambridge.