Markdown content imported from another file don't show in Table of Contents

[SuperKXT]

What version of starlight are you using?

0.33.1

What is your idea?

I have divided a page into multiple sub-files, and I import them into the main file.

The automatic Table of Contents only picks up the headings directly added to the document.
The headings from the sub-files are ignored.

Why is this feature necessary?

This limitation requires a manual table of contents specification for multi-file pages.

Do you have examples of this feature in other projects?

No response

Participation

• I am willing to submit a pull request for this feature.

[HiDeoo]

👋 Thanks for the feedback.

This behavior is a limitation of Astro which is in charge of generating the list of headings that Starlight uses to generate the table of contents as described in #2078.

This issue and more specifically this comment contains a few workarounds for this limitation.