Skip to content

droxey/tocsify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📋 tocsify

NPM version NPM downloads

📋 npm module that generates a table of contents based on the file structure of a Docsify docs directory!

Features

  • Adds relative path to title in each top-level entry for context.
  • Skips markdown files beginning with _.
  • Allows users to specify maxdepth for 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.

Installation

Install globally for use in any Docsify project!

npm install -g tocsify

Usage

 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=false

Integration

Integration 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.

Packages

No packages published