Markdown links inside JSX components and OpenAPI descriptions are not rewritten on subpath deployments

[5kbpers]

Summary

On a /docs subpath deployment (reverse proxy via Cloudflare Workers, per https://mintlify.com/docs/deploy/docs-subpath), Mintlify correctly rewrites sidebar navigation links and <Card href> attributes to include the subpath prefix, but does not rewrite markdown [text](/v2/foo) links that appear inside:

• JSX callout components such as <Tip>, <Note>, <Warning>, <Info>
• OpenAPI description fields (operation descriptions, parameter descriptions, schema property descriptions)

This produces dead links on every deployed page that uses those patterns.

Reproduction

Deploy any docs site at a /docs subpath (e.g. Cloudflare Worker that proxies example.com/docs/* to Mintlify with X-Forwarded-Host).

1. Create a page foo.mdx with both forms:

   See [Bar](/bar) in a plain paragraph.
   
   <Tip>
   Also see [Bar](/bar) inside a Tip.
   </Tip>

2. Visit example.com/docs/foo in production and inspect the rendered anchors:

Context	Rendered href	Result
Plain paragraph	/docs/bar	works
Sidebar / <Card href="/bar">	/docs/bar	works
Inside <Tip> (markdown link)	/bar	404
Inside <Tip> (HTML <a href="/bar">)	/bar	404
Inside <Tip> with relative [Bar](bar)	bar + target="_blank" rel="noreferrer"	browser resolves URL correctly but link is flagged as external and opens in a new tab
OpenAPI spec description: "See [Bar](/bar)"	/bar	404

Expected behavior

All internal markdown links should receive the same subpath-aware rewriting regardless of whether they appear in a plain paragraph, inside a JSX component, or inside an OpenAPI description field. Relative paths inside JSX components should not be flagged as external.

Current workaround

Rewrite every affected link to a hardcoded absolute URL (https://example.com/docs/bar). Downsides:

• Breaks mint dev local preview — clicks leave the local server and jump to production.
• Every link is treated as external, so all cross-references open in a new tab.
• All existing docs authored against the documented [text](/path) convention need to be rewritten.

Environment

• Deployment: /docs subpath via Cloudflare Worker reverse proxy with X-Forwarded-Host, following the official subpath guide.
• mint CLI: latest
• Affected page types: all MDX pages using <Tip>/<Note>/<Warning> for cross-references, and all pages backed by an OpenAPI spec with markdown links in description fields.

Suggested fix

Apply the subpath rewrite pass to the full MDX AST (including JSX component children) and to all markdown strings coming from the OpenAPI spec — not only to top-level markdown nodes and known navigation props.