Skip to content

Document relative link resolution in MDX files#5384

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/relative-links-fix-1776270322
Open

Document relative link resolution in MDX files#5384
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/relative-links-fix-1776270322

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 15, 2026

Summary

  • Updated the linking guide to document relative path support (./ and ../) including how they resolve in index.mdx files
  • Added a changelog entry for the bug fix that corrected relative link resolution in index pages

Relative links in MDX files now resolve correctly based on the source file's location. Previously, relative paths like ./foo in index.mdx files resolved against the wrong directory, causing broken links.


Note

Low Risk
Low risk: documentation-only updates (linking guide + changelog) with no runtime or configuration changes.

Overview
Adds documentation for relative paths (./, ../) in guides/linking.mdx, including how resolution works for index.mdx files, plus examples and guidance on when to prefer root-relative vs relative links.

Adds an April 15, 2026 changelog entry noting the bug fix that corrected relative link resolution on index pages.

Reviewed by Cursor Bugbot for commit 5da227e. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 15, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 15, 2026, 4:31 PM

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.

0 participants