Headings To create a heading, add number signs (#) in front of a word or phrase. The number of number signs you use should correspond to the heading level. For example, to create a heading level three (<h3>), use three number signs (e.g., ### My Header). Alternate Syntax Alternatively, on the line below the text, add any number of == characters for heading level 1 or -- characters for heading level 2. Heading Best Practices ✅  Do this

❌  Don't do this



# Here's a Heading

#Here's a Heading You should also put blank lines before and after the heading for compatibility. ✅  Do this

❌  Don't do this



Try to put a blank line before…# Heading…and after a heading

Without blank lines, this might not look right.# HeadingDon’t do this! This guide is a Matt Cone project available on Markdown Guide under the CC BY-SA 4.0 license. Headings To create a heading, add number signs ( # ) in front of a word or phrase. The number of number signs you use should correspond to the heading level. For example, to create a heading level three ( <h3> ), use three number signs (e.g., ### My Header ). # <h3> ### My Header Alternate Syntax Alternatively, on the line below the text, add any number of == characters for heading level 1 or -- characters for heading level 2. == -- Heading Best Practices ✅  Do this

❌  Don't do this



# Here's a Heading

#Here's a Heading ✅  Do this

❌  Don't do this # Here's a Heading

#Here's a Heading ✅  Do this ❌  Don't do this ✅  Do this ✅  Do this ❌  Don't do this ❌  Don't do this # Here's a Heading #Here's a Heading # Here's a Heading # Here's a Heading # Here's a Heading #Here's a Heading #Here's a Heading #Here's a Heading You should also put blank lines before and after the heading for compatibility. ✅  Do this

❌  Don't do this



Try to put a blank line before…# Heading…and after a heading

Without blank lines, this might not look right.# HeadingDon’t do this! ✅  Do this

❌  Don't do this Try to put a blank line before…# Heading…and after a heading

Without blank lines, this might not look right.# HeadingDon’t do this! ✅  Do this ❌  Don't do this ✅  Do this ✅  Do this ❌  Don't do this ❌  Don't do this Try to put a blank line before…# Heading…and after a heading Without blank lines, this might not look right.# HeadingDon’t do this! Try to put a blank line before…# Heading…and after a heading Try to put a blank line before… # Heading …and after a heading Without blank lines, this might not look right.# HeadingDon’t do this! Without blank lines, this might not look right. # Heading Don’t do this! This guide is a Matt Cone project available on Markdown Guide under the CC BY-SA 4.0 license. This guide is a Matt Cone project available on Markdown Guide under the CC BY-SA 4.0 license. Matt Cone Markdown Guide

Too Long; Didn't Read

Boost your HackerNoon story @ $159.99! 🚀

The Dead Simple Markdown Guide to Headings

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

Towards the Automation of Book Typesetting: Experimentation and Discussion

Here's How You Can Build Your Own Markdown Parser: Part 2 - How to Read File From the Command Line

Getting Started with Building a Markdown Parser in Rust

How I Made My Next.js Blog Serve Markdown Files for Agent Experience SEO (AX-SEO)

Automate Your Writing: Publishing to Medium with Python and the Medium API

Towards the Automation of Book Typesetting: Experimentation and Discussion

Here's How You Can Build Your Own Markdown Parser: Part 2 - How to Read File From the Command Line

Getting Started with Building a Markdown Parser in Rust

How I Made My Next.js Blog Serve Markdown Files for Agent Experience SEO (AX-SEO)

Automate Your Writing: Publishing to Medium with Python and the Medium API

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps