Lessons
Basic Formatting·3 / 19

Headings

Structure your content with headings from H1 to H6.

Headings

Headings create the structure of your document. Use the # symbol followed by a space to create headings.

Syntax

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Rules to Remember

  • Always put a space after the # symbol
  • Use only one H1 per document (it's your title)
  • Don't skip heading levels (go H1 → H2 → H3, not H1 → H3)
  • Headings help with accessibility and SEO

Alternative Syntax

For H1 and H2, you can also use underline style:

Heading 1
=========

Heading 2
---------

💡 The # style is more common and recommended.

Best Practices

  • Use headings to create a clear document outline
  • Keep heading text concise and descriptive
  • Think of headings like a table of contents

Practice

Markdown Input
Live Preview

Heading Level 1

Heading Level 2

Heading Level 3

Now try levels 4, 5, and 6 below:

PreviousNext