Heading IDs
Headings can be given custom ID numbers
Heading ID Syntax
Many Markdown editors allow you to create custom heading IDs for CSS modifications. To add a heading ID, wrap the custom ID in curly braces on the same line as the heading.
### Flowers Blooming in the Church {#flowers-id}
The corresponding HTML structure is:
<h3 id="flowers-id">Flowers Blooming in the Church</h3>
Linking to Heading IDs
You can link to headings with custom IDs in the file by creating standard links with #.
| Markdown | HTML | Preview |
|---|---|---|
[Flowers Blooming in the Church](#flowers-id) | <a href="#flowers-id">Flowers Blooming in the Church</a> | Flowers Blooming in the Church |
Best Practices for Heading IDs
Use Descriptive IDs
Use descriptive IDs that clearly indicate the content of the heading.
### Getting Started with Markdown {#getting-started}
### Advanced Features {#advanced-features}
### Troubleshooting {#troubleshooting}
Avoid Special Characters
Avoid using spaces and special characters in heading IDs. Use hyphens or underscores instead.
| ✅ Do this | ❌ Don't do this |
|---|---|
#getting-started | #getting started |
#advanced-features | #advanced.features |
#troubleshooting | #troubleshooting! |