description: Mintlify Steps anchors — use markdown headings inside Step so in-page links work globs: docs/**/*.mdx alwaysApply: false

Mintlify Steps and in-page anchors

Mintlify <Step title="..."> does not create a heading ID. Links like #run-the-agent-locally will do nothing if they target a Step title prop.

Do this

Put a real markdown heading inside <Step> when anything needs to link to that step (or when you want TOC/anchor support):

<Steps>
  <Step>
## Run the agent locally

Content here.
  </Step>
</Steps>

Then link with:

skip to [Run the agent locally](#run-the-agent-locally)

Do not do this

{/* ❌ title prop is not an anchor target */}
<Step title="Run the agent locally">
...
</Step>

skip to [Run the agent locally](#run-the-agent-locally)

Pattern reference

See docs/agents/custom-code-agent/quickstart.mdx and docs/agents/get-started/ai-sdk.mdx for working examples.