Headings
Last updated: 03/04/2026Edit this page
Use standard markdown headings (##, ###, ####). Each heading automatically gets an anchor link with a copy-to-clipboard button on hover.
Every heading in Trellis Docs documentation (##, ###, ####) automatically gets an anchor link. Hover over any heading to see a link icon — select it to copy the anchor URL to your clipboard.
How it works
An id attribute is generated for each heading based on its text content. Trellis Docs enhances this with:
- Visible link icon — appears on hover to the left of the heading text
- Copy to clipboard — selecting the icon copies the full URL (including the
#anchorfragment) to your clipboard - Keyboard accessible — the anchor link is focusable and activates on Enter
Anchor ID generation
Heading IDs follow standard conventions:
| Heading | Generated ID |
|---|---|
## Getting Started | #getting-started |
## How It Works | #how-it-works |
### API Reference (v2) | #api-reference-v2 |
You can also set a custom ID:
## My Heading {#custom-id}Linking to headings
Use the generated anchor in markdown links:
See the [configuration section](#configuration) below.
Or link to another page's heading:
[Smart Search weights](/guides/search/#configuration)