Section Headings | Components

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.

Recommended structure

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.