📋 npm module that generates a table of contents based on the file structure of a Docsify docs directory!
- Adds relative path to title in each top-level entry for context.
- Skips markdown files beginning with
_. - Allows users to specify
maxdepthfor cleaner generation. - Skips generation for headers marked
{docsify-ignore} - If
{docsify-ignore-all}exists in a top level header (# Example Header {docsify-ignore-all}), skip generating the table of contents for the entire document.
Install globally for use in any Docsify project!
npm install -g tocsify Usage $ tocsify docs --file=docs/toc.md Options --verbose, -v Write output to stdout. --file, -f Write output to file. --header, -h Include a descriptive header. Default is true. --maxdepth, -m Specify max level header(1 - 6) to output. Default is 3. Examples $ tocsify docs --file=docs/toc.md $ tocsify docs --verbose --file=docs/toc.md $ tocsify docs --maxdepth=2 $ tocsify docs --header=falseIntegration with a Docsify homepage is easy!
In index.md or _sidebar.md, paste the snippet below where the Table of Contents should appear:
## Table of Contents [filename](toc.md ':include')A working index.md file can be found in the docs directory here for reference.