Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »

tocsify

1.0.11 • Public • Published

📋 tocsify

NPM version NPM downloads Build Status Dependencies Status DevDependencies Status License: MIT

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

install

npm i tocsify

Downloadsweekly downloads

72

version

1.0.11

license

MIT

homepage

droxey.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability