Markdown Headings

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 <h1> to <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.

Rendered Output

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

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.