Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

MD035 - Horizontal Rule Style

Horizontal rule style should be consistent.

Why This Rule Exists

Markdown supports multiple horizontal rule syntaxes. Consistent style throughout a document improves readability and maintainability.

Styles

---

---


---


---


** *

All render as horizontal rules but mixing them is inconsistent.

Examples

Incorrect

Section one content.

---

Section two content.

---


Section three content.

Correct

Section one content.

---

Section two content.

---

Section three content.

Configuration

[MD035]
style = "---"  # Options: "---", "***", "___", "consistent"
ValueDescription
---Three dashes
***Three asterisks
___Three underscores
consistentMatch first occurrence

When to Disable

  • Documents with intentional style variation
  • Content imported from multiple sources

Rule Details

  • Rule ID: MD035
  • Aliases: hr-style
  • Category: Formatting
  • Severity: Warning
  • Auto-fix: Yes
  • MD003 - Heading style consistency
  • MD004 - Unordered list style consistency