Cursor rule

1---
2description: Mintlify Steps anchors — use markdown headings inside Step so in-page links work
3globs: docs/**/*.mdx
4alwaysApply: false
5---
6 
7# Mintlify Steps and in-page anchors
8 
9Mintlify `<Step title="...">` does **not** create a heading ID. Links like `#run-the-agent-locally` will do nothing if they target a Step `title` prop.
10 
11## Do this
12 
13Put a real markdown heading inside `<Step>` when anything needs to link to that step (or when you want TOC/anchor support):
14 
15```mdx
16<Steps>
17  <Step>
18## Run the agent locally
19 
20Content here.
21  </Step>
22</Steps>
23```
24 
25Then link with:
26 
27```mdx
28skip to [Run the agent locally](#run-the-agent-locally)
29```
30 
31## Do not do this
32 
33```mdx
34{/* ❌ title prop is not an anchor target */}
35<Step title="Run the agent locally">
36...
37</Step>
38 
39skip to [Run the agent locally](#run-the-agent-locally)
40```
41 
42## Pattern reference
43 
44See `docs/agents/custom-code-agent/quickstart.mdx` and `docs/agents/get-started/ai-sdk.mdx` for working examples.
45