Improve internal linking within pages

[michielmulders]

Issue

Summary

Currently, the Mintlify editor does not provide native support or auto-completion for adding internal links between sections within the same document. This limitation makes it cumbersome to create in-page navigation elements, such as a mini table of contents.

Steps to Reproduce

1. Try adding a link to a section within the same page (e.g. /my-tutorial#step-1-step-title).
2. Notice that there’s no auto-complete or suggestion support for existing section IDs or headings.

Observed Behavior

• Internal links must be manually typed with the correct section anchor.
• The only reliable way to find section IDs is by viewing the published page and inspecting the generated HTML/hoovering over the header link icon.

Additional Issue: Escaped Characters in IDs

When a heading includes special characters such as colons (:), Mintlify generates HTML-escaped IDs (e.g.
.../on-hashscan#step-1%3A-contract-calling).
In most cases, authors expect the section ID to omit or normalize such characters (e.g.
#step-1-contract-calling).

Expected Behavior

• The editor should provide auto-complete support for section anchors (similar to Markdown link auto-completion in other doc tools).
• Generated section IDs should be clean and consistent, ideally excluding escaped characters or offering a clear rule for how IDs are constructed.

Why It Matters

These improvements would make it significantly easier to:

• Build internal navigation within long tutorials / or support a TOC component.
• Reduce errors in linking to specific sections.
• Improve overall authoring efficiency in Mintlify.