Document feature to create custom Table of Contents

[PaulRBerg]

Have you read the Contributing Guidelines on issues?

• I have read the Contributing Guidelines on issues.

Description

Problem

It took me 10 minutes to wade through several discussions, issues, and PRs, to find out that it is possible to customize the TOC in an MDX file.

Solution

Document feature to create custom Table of Contents:

export const toc = [
  {
    "value": "Doc heading",
    "id": "doc-heading",
    "level": 2
  },
]

References

• feat(mdx-loader): the table-of-contents should display toc/headings of imported MDX partials #9684 (comment)
• How to make the table of contents show headers added with React in an MDX file? #8974 (reply in thread)
• TOC does not work when importing one MDX into another #3915 (comment)

Self-service

• I'd be willing to address this documentation request myself.

Documentation that may already cover this requirement:
https://docusaurus.io/docs/markdown-features/toc#inline-table-of-contents