kiruthiga 55473b7e7c initial push		5 日前
..
index.js	55473b7e7c initial push	5 日前
license	55473b7e7c initial push	5 日前
package.json	55473b7e7c initial push	5 日前
readme.md	55473b7e7c initial push	5 日前

remark-toc

Generate a Table of Contents in remark.

Installation

npm:

npm install remark-toc

Usage

Say we have the following file, example.md:

# Alpha

## Table of Contents

## Bravo

### Charlie

## Delta

And our script, example.js, looks as follows:

var vfile = require('to-vfile')
var remark = require('remark')
var toc = require('remark-toc')

remark()
  .use(toc)
  .process(vfile.readSync('example.md'), function(err, file) {
    if (err) throw err
    console.log(String(file))
  })

Now, running node example yields:

# Alpha

## Table of Contents

-   [Bravo](#bravo)

    -   [Charlie](#charlie)

-   [Delta](#delta)

## Bravo

### Charlie

## Delta

API

`remark().use(toc[, options])`

Add a Table of Contents to a Markdown document.

Looks for the first heading containing 'Table of Contents', 'toc', or 'table-of-contents' (case insensitive, supports alt/title attributes for links and images too)
Removes all following contents until an equal or higher heading is found
Inserts a list representation of the hierarchy of following headings
Adds links to following headings, using the same slugs as GitHub

Options

`heading`

string?, default: 'toc|table[ -]of[ -]contents?' — Heading to look for, wrapped in new RegExp('^(' + value + ')$', 'i').

`maxDepth`

number?, default: 6 — Maximum heading depth to include in the table of contents, This is inclusive, thus, when set to 3, level three headings, are included (those with three hashes, ###).

`tight`

boolean?, default: false — Whether to compile list-items tightly.

remark-collapse – Make a section collapsible
remark-normalize-headings — Make sure there is no more than a single top-level heading in the document and rewrite the rest accordingly
remark-rewrite-headers — Change header levels
mdast-util-toc — Core functionality of this plugin

Contribute

See contributing.md in remarkjs/remark for ways to get started.

This organisation has a Code of Conduct. By interacting with this repository, organisation, or community you agree to abide by its terms.

readme.md