The Dead Simple Markdown Guide to Horizontal Rules

cover
20 Aug 2024

Horizontal Rules

To create a horizontal rule, use three or more asterisks (***), dashes (---), or underscores (___) on a line by themselves.

***

---

_________________

The rendered output of all three looks identical:

Horizontal Rule Best Practices

For compatibility, put blank lines before and after horizontal rules.

✅  Do this

❌  Don't do this

Try to put a blank line before...

---

...and after a horizontal rule.

Without blank lines, this would be a heading.
---
Don't do this!

This guide is a Matt Cone project available on Markdown Guide under the CC BY-SA 4.0 license.