JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 214201
  • Score
    100M100P100Q170327F
  • License MIT

Generate a Table of Contents (TOC) for Markdown files

Package Exports

  • remark-toc

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (remark-toc) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

remark-toc Build Status Coverage Status remark

Generate a Table of Contents in remark.

Installation

npm:

npm install remark-toc

remark-toc is also available as an AMD, CommonJS, and globals module, uncompressed and compressed.

Usage

Dependencies:

var remark = require('remark');
var toc = require('remark-toc');

Process:

var doc = remark().use(toc).process([
    '# Alpha',
    '',
    '## Table of Contents',
    '',
    '## Bravo',
    '',
    '### Charlie',
    '',
    '## Delta',
    ''
].join('\n'));

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 (Object, optional):

  • slug — Passed to remark-slug;

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

License

MIT © Titus Wormer