Horizontal Rules

Horizontal rules create visual breaks and section dividers in your Markdown documents.

Basic Syntax

Three or More Dashes

---

Result:

Three or More Asterisks

---

Result:

Three or More Underscores

---

Result:

Spacing and Placement

With Spacing

Content above

---

Content below

Result: Content above

Content below

Multiple Rules

Section 1

---

Section 2

---

Section 3

---

Final section

Result: Section 1

Section 2

Section 3

Final section

Practical Uses

Document Sections

# Introduction

This is the introduction to our guide.

---

# Main Content

Here's the main content of the document.

---

# Conclusion

Final thoughts and summary.

Blog Post Separators

## Article Summary

Key points from today's discussion.

---

_Published on January 15, 2024_
_Author: John Doe_

API Documentation

## GET /users

Retrieve a list of users.

---

## POST /users

Create a new user.

---

## PUT /users/{id}

Update an existing user.

Best Practices

1. Use Sparingly

Don't overuse horizontal rules:

✅ Good:

# Chapter 1

Content...

---

# Chapter 2

More content...

❌ Overused:

# Title

---

## Subtitle

---

## Content

## More content

2. Consistent Style

Pick one style and stick with it:

✅ Consistent:

## Section 1

## Section 2

Section 3

3. Proper Spacing

Always add blank lines around horizontal rules:

✅ Good spacing:

Content above

---

Content below

❌ Poor spacing:

## Content above

Content below

Horizontal rules provide clean visual separation – use them to organize content and improve readability!