Embed tooltips in to docs

[NWylynko]

Was blocked by https://github.com/clerk/clerk/pull/1359

🔎 Previews:

• https://clerk.com/docs/pr/nick-embed-tooltips/nextjs/hooks/use-organization-list

What does this solve?

Extracts

[Hover me](!ABC)

pulls the content from the _tooltips/ABC.mdx file,

and transforms it in to

<Tooltip>
  <TooltipTrigger>Hover me</TooltipTrigger>
  <TooltipContent>ABC</TooltipContent>
</Tooltip>

This is because mdx is weird and children props get treated differently to standard props. So to ensure that both the title text and the tooltip content are treated as mdx not just a string, we need to embed them in to there own children inside components.

Checklist

• I have clicked on "Files changed" and performed a thorough self-review
• All existing checks pass

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
clerk-docs	Ready	Preview	Sep 17, 2025 10:38am

[alexisintech]

I'm thinking we should the change the syntax from
Hover me

to

Hover me

and then the logic will understand that the ! means to look in the _tooltips folder and find the file that is named ABC.mdx

what are your thoughts on this syntax? also, this is something I can try work on! or maybe we can pair :)

[alexisintech]

if there are links in a tooltip, does the link checker accommodate those?

[NWylynko]

if there are links in a tooltip, does the link checker accommodate those?

I'll have to check, I'll add a test, I hope its yes, my hunch is no.