mdast-util-toc

What is mdast-util-toc?

The `mdast-util-toc` package is a utility for generating a Table of Contents (TOC) from Markdown Abstract Syntax Trees (MDAST). It is particularly useful for processing Markdown documents and extracting a structured TOC based on headings.

What are mdast-util-toc's main functionalities?

Generate TOC from MDAST

This feature allows you to generate a Table of Contents from a Markdown Abstract Syntax Tree. The code sample demonstrates how to convert a Markdown string into an MDAST, generate a TOC from it, and then convert the TOC back into a Markdown string.

const { toMarkdown } = require('mdast-util-to-markdown');
const { fromMarkdown } = require('mdast-util-from-markdown');
const { toc } = require('mdast-util-toc');

const markdown = '# Title\n## Subtitle\n### Sub-subtitle';
const tree = fromMarkdown(markdown);
const tocNode = toc(tree);
console.log(toMarkdown(tocNode.map));

Custom Heading Levels

This feature allows you to customize the depth of headings included in the TOC. The code sample demonstrates generating a TOC that includes only headings up to level 2.

const { fromMarkdown } = require('mdast-util-from-markdown');
const { toc } = require('mdast-util-toc');

const markdown = '# Title\n## Subtitle\n### Sub-subtitle';
const tree = fromMarkdown(markdown);
const tocNode = toc(tree, { maxDepth: 2 });
console.log(tocNode.map);

Custom TOC Heading

This feature allows you to specify a custom heading for the TOC. The code sample demonstrates generating a TOC with a custom heading 'Table of Contents'.

const { fromMarkdown } = require('mdast-util-from-markdown');
const { toc } = require('mdast-util-toc');

const markdown = '# Title\n## Subtitle\n### Sub-subtitle';
const tree = fromMarkdown(markdown);
const tocNode = toc(tree, { heading: 'Table of Contents' });
console.log(tocNode.map);

Other packages similar to mdast-util-toc

remark-toc

The `remark-toc` package is a plugin for the `remark` Markdown processor that generates a Table of Contents. It is similar to `mdast-util-toc` but is designed to be used directly within the `remark` ecosystem, making it easier to integrate if you are already using `remark`.

markdown-toc

The `markdown-toc` package generates a Table of Contents for Markdown files. Unlike `mdast-util-toc`, which works with MDAST, `markdown-toc` operates directly on Markdown strings, making it simpler to use for straightforward TOC generation without needing to parse the Markdown into an abstract syntax tree.

markdown-it-toc-done-right

The `markdown-it-toc-done-right` package is a plugin for the `markdown-it` Markdown parser that generates a Table of Contents. It is similar to `mdast-util-toc` in functionality but is designed to work within the `markdown-it` ecosystem, providing seamless integration if you are using `markdown-it` for Markdown processing.

README

The README file is missing