TOC Export

Exports the page table-of-contents as an `export const toc` named export.

The tocExport feature walks a document's headings and injects an MDX named export — export const toc — at the top of each processed file, giving sidebar and floating-TOC components a structured table-of-contents.

Configuration

It is an object-typed feature, so it must be given an options object (the true shorthand is rejected). Enable with defaults (maxDepth: 3):

export default defineConfig({
  markdown: {
    features: {
      tocExport: {},
    },
  },
});

Limit the heading depth:

tocExport: { maxDepth: 2 },

Options

Exported shape

The feature injects an export const toc whose entries follow this type:

type TocEntry = {
  depth: number; // absolute heading depth: 2 | 3 | 4 | 5 | 6
  id: string; // slug assigned by the heading-links pass
  text: string; // plain-text heading content (hash-link stripped)
  children: TocEntry[]; // nested sub-headings within maxDepth
};

Example output

For a document with h2 and h3 headings, the injected export looks like:

export const toc = [
  {
    depth: 2,
    id: "introduction",
    text: "Introduction",
    children: [{ depth: 3, id: "introduction-background", text: "Background", children: [] }],
  },
  { depth: 2, id: "conclusion", text: "Conclusion", children: [] },
];

The nested id: "introduction-background" reflects this site's hierarchical Heading Links strategy (the h3 id is prefixed with its h2 ancestor). Under the flat strategy it would simply be id: "background".

Notes

• The export runs after the heading-links pass, so the id slugs are final, deduplicated, and follow the configured heading-ID strategy.

• tocExport works independently of Heading Marker TOC — enabling one does not interfere with the other.

• zudo-doc's existing TOC island is not driven by this export; the two are separate mechanisms.