Compass

Section Headings

Use H2, H3, and H4 headings to create a clear article structure without adding custom UI.

In Compass, the article title is already the page h1, so inside the article you usually only need h2, h3, and sometimes h4.

Use in MDX

Write normal Markdown headings in your article:

## Main section
### Sub-section
#### Rare deeper note

Implementation notes

No extra component is required here. The article route and typography styles already handle Markdown headings automatically, so if you want to change their appearance, update the prose styles in src/index.css.

  • h1 is always the article title
  • h2 is a major section
  • h3 is a subsection inside that section
  • h4 is only for the rare case where one more layer is necessary

Preview

## Set up the project
Intro sentence for the section.

### Install dependencies
Explain the step.

### Run the project
Explain the next step.

## Troubleshooting
Add common fixes here.

### Port already in use
Explain the issue.

#### Quick fix
Give the exact command or action.

Updated June 3, 2026