Markdown supports two styles of headers.
- Setext Style
- ATX Style
The most widely used style is
atx style as it's very simple and concise.
Setext Style Heading Example
This is Setext Style H1 =============
ATX Style Heading Example
# This is atx style H1
Headings are commonly known as Titles and Subtitles that you want to display in the documents.
There is a total of six different types of headings available in markdown. These are similar to HTML headings
<h6> tags where
<h1> signifies most important heading and
<h6> signifies least important heading.
In Markdown, we define headings using the Hash/Number Sign (#). To create a heading in markdown, add the Number Sign (#) in front of the word or sentence.
The number of
# infornt of a word or phrase will determine the size of the heading.
Let us look at different types of markdown headings.
|# Heading 1||<h1> Heading 1 </h1>|
|## Heading 2||<h2> Heading 2 </h2>|
|### Heading 3||<h3> Heading 3 </h3>|
|#### Heading 4||<h4> Heading 4 </h4>|
|##### Heading 5||<h5> Heading 5 </h5>|
|###### Heading 6||<h6> Heading 6 </h6>|
Alternatively, we can use
Setext style syntax for Heading l and Heading 2. The Setext style headers are "underlined" using the equals sign(
=) for Heading 1 and "dashes" (
-) for Heading 2.
Heading 1 ========= Heading 2 ---------
✅ Best Practices
- Ensure to add a space after the number signs (
#) else, the markdown editors/application won't parse into a markdown heading.
- Add a new line before and after the headings for compatibility.
- Use ATX-style headings as it is easier to write and keeps the markdown syntax clean and concise.