I have updated Ruby gem markdown_helper .

Page TOC (table of contents) is improved:

Old : You would first run the markdown helper to generate a page TOC, then run the helper a second time to include the page TOC where you want it.

New: You specify the site for the page TOC in the page itself, and the page TOC is automatically generated and inserted there. See the use case.

Note that the page TOC is created after any markdown file inclusions, so the TOC covers the entire finished page.

The old way is now deprecated.