Headings

Remark Heading

Apply ids to headings.

import { remarkHeading } from 'fumadocs-core/mdx-plugins';
 
export default {
  remarkPlugins: [remarkHeading],
};

By default, it extracts the headings (table of contents) of a document to vfile.data.toc. You can disable it with:

import { remarkHeading } from 'fumadocs-core/mdx-plugins';
 
export default {
  remarkPlugins: [[remarkHeading, { generateToc: false }]],
};

You can customise the heading id with [#slug].

# heading [#slug]

An array of TOCItemType.

Export table of contents (an array of TOCItemType), it allows JSX nodes which is not possible with a Remark plugin.

It requires MDX.js.

import { rehypeToc } from 'fumadocs-core/mdx-plugins';
 
export default {
  remarkPlugins: [rehypeToc],
};

For a Markdown document:

## Hello `code`

An export will be created:

export const toc = [
  {
    title: (
      <>
        Hello <code>code</code>
      </>
    ),
    depth: 2,
    url: '#hello-code',
  },
];