Learn how to create horizontal rules (dividers) in markdown using hyphens, asterisks, or underscores. Syntax and platform support.
A horizontal rule creates a visual divider across the page. In markdown, use three or more hyphens (---), asterisks (***), or underscores (___) on their own line. Horizontal rules separate sections and improve document readability.
Three hyphens — the most common way to create a horizontal rule.
Three asterisks also work.
Three underscores — less common but equally valid.
| Platform | Supported | Notes |
|---|---|---|
| GitHub | Yes | — |
| GitLab | Yes | — |
| Discord | No | No horizontal rule support |
| Slack | No | No horizontal rule support |
| Yes | — | |
| Stack Overflow | Yes | — |
| Notion | Yes | Use --- or /divider command |
| Obsidian | Yes | — |
Text ---
Text ---
Without a blank line above, --- after text creates an H2 heading (alternate syntax) instead of a horizontal rule.
--
---
You need at least three characters. Two hyphens won't render a horizontal rule.
Put a blank line before and after --- to avoid it being interpreted as a heading underline.
Section 1 --- Section 2
Horizontal rules are strong visual breaks. Use headings for most section divisions and reserve rules for major topic transitions.
All three syntaxes work identically, but --- is the most conventional and readable.
Everything you need to know.
Type three or more hyphens (---), asterisks (***), or underscores (___) on their own line with blank lines above and below.
Markdown headings are created with hash symbols (#). One hash for H1 (largest), two for H2, up to six for H6 (smallest). Headings structure your document and create a hierarchy that readers and search engines can follow.
In markdown, pressing Enter once doesn't create a visible line break — the text continues on the same line. To force a line break (without starting a new paragraph), end the line with two spaces or a backslash (\).
Blockquotes in markdown start with a greater-than sign (>) followed by a space. They render as indented, visually distinct blocks — perfect for quoting text, highlighting notes, or calling out important information.
Paste your markdown and see horizontal rule rendered instantly with professional themes.