Skip to content

Document custom heading IDs in MDX#4622

Closed
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/custom-heading-ids-1773784632
Closed

Document custom heading IDs in MDX#4622
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/custom-heading-ids-1773784632

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Mar 17, 2026

Summary

  • Added a "Custom heading IDs" section to create/text.mdx explaining the {#custom-id} syntax for overriding auto-generated anchor links on headings (h1-h4)
  • Updated guides/linking.mdx to mention the custom ID override option in the "How anchor links are generated" section with a cross-reference

Related: mintlify/mint#6586


Note

Low Risk
Low risk documentation-only change that adds guidance and examples for overriding auto-generated anchor slugs; no runtime behavior is modified.

Overview
Documents custom heading IDs for MDX headings via {#custom-id} in create/text.mdx, including slugification behavior, supported heading levels (H1–H4), and collision handling.

Updates guides/linking.mdx to mention the custom-ID override in the anchor-generation section, with an example and cross-link back to the new docs section.

Written by Cursor Bugbot for commit 2ba2c4c. This will update automatically on new commits. Configure here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant