Headings are created by adding hash signs # in front of a word or sentence. The number of hashes indicates the level of the heading: a single # indicates a level 1 heading, ## a level 2 all the way down to ###### (six hashes) which is a level 6 heading.

The headings can also be constructed using the HTML tags <h1></h1> … <h6></h6>.

Headings are also covered in section 16.5.2; this shows how headings are structured for the PracticalSeries Wikis and includes a lot of information about spacing and numbering and generally making the headings look better.

Headings level 1 and 2 are underlined. Headings get progressively smaller:

Figure 6.3 — Markdown headings on GitHub

The above headings are produced with the following Markdown:

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

<h1>Heading level 1</h1>
<h2>Heading level 2</h2>
<h3>Heading level 3</h3>
<h4>Heading level 4</h4>
<h5>Heading level 5</h5>
<h6>Heading level 6</h6>

Headings 1 and 2 can be recreated by adding equal signs = for heading level 1 or minus signs - for heading level 2.

The equals or minus signs must be added to the line immediately below the heading text. It doesn’t matter how many equals or minus signs, one will do, but often the signs are extended for the length of the heading text:

Heading level 1
=====
Heading level 2
-----

<h1>Heading level 1</h1>
<h2>Heading level 2</h2>

${\LARGE \color{#C00000}\text{DO\ NOT\ USE\ EQUALS\ AND\ MINUS\ SIGNS\ FOR\ HEADINGS}}$

It is generally best not to use these alternatives; they only cover the first two heading levels — stick with the hashes.

⬆️ Top

⬆️ Top

The following are the GitHub properties applied to each heading: