Markdown Line Breaks
Creating a Markdown line break isn't always as simple as pressing Enter. Pressing it once usually produces a soft break, not a guaranteed visible new line β how it renders depends on the Markdown processor and where it's published. Getting a reliable, visible break takes one of a few specific methods.
New to Markdown? Start with Markdown Basics. For the blank-line rule that separates paragraphs (a different thing from a line break), see Markdown Paragraphs.
π‘ Practice as you read: Open the Markdown Editor for live preview.
Quick Answer
To force a visible line break in Markdown:
- Add two trailing spaces at the end of a line, then press Enter.
- End the line with a backslash (
\) β explicitly supported by CommonMark. - Use the HTML
<br>tag when your target platform allows inline HTML and you need an explicit break. - Leave a blank line if you actually want a new paragraph, not just a new line.
Rendering can vary slightly between GitHub Flavored Markdown (GFM), CommonMark, and other processors β preview before publishing.
Line Break Methods at a Glance
| Method | New line? | New paragraph? | Best for |
|---|---|---|---|
| Soft break (Enter once) | Depends on the parser | Keeping source text readable β not reliable for visible breaks | |
| Hard break (two trailing spaces) | Addresses, poetry, contact details | ||
Backslash (\) |
CommonMark-compatible documents | ||
| Blank line | Normal paragraphs | ||
HTML <br> |
Explicit breaks on platforms that allow inline HTML |
Soft Break#
This is line one.
This is line two.
Live Preview
This is line one. This is line two.
Most parsers merge these into one paragraph, commonly rendering the join as a space β but this is processor-dependent, not a universal rule. Fine for readable source files, not reliable for an actual visible break.
Hard Break (Two Trailing Spaces)#
First line.Β·Β·
Second line.
(Β·Β· represents two trailing spaces β shown only to make them visible.)
Live Preview
First line.
Second line.
This is the traditional Markdown syntax and is supported by GFM and most modern processors.
Backslash Break#
First line.\
Second line.
Live Preview
First line.
Second line.
CommonMark explicitly supports this method. Many developers prefer it over trailing spaces because the backslash is visible in the raw source β nothing invisible to accidentally delete.
Paragraph Break (Blank Line)#
This is the first paragraph.
This is the second paragraph.
Live Preview
This is the first paragraph.
This is the second paragraph.
The standard way to separate ideas in articles, documentation, and long-form content. See Markdown Paragraphs for the full rules.
The <br> Tag#
First line<br>
Second line
Live Preview
First line
Second line
Use it when your target platform supports inline HTML and an explicit break is easier to read in the source than trailing spaces. Multiple <br> tags can add vertical spacing, but a paragraph break is usually the cleaner way to do that.
GitHub & CommonMark Behavior
| Environment | Two spaces | Backslash (\) |
<br> |
|---|---|---|---|
| GitHub / GFM | |||
| CommonMark-compatible processors | Depends on whether HTML is enabled | ||
| Other Markdown tools (static site generators, editors, etc.) | Usually supported | Varies by tool | Depends on HTML support |
GitHub Flavored Markdown supports all four methods β two trailing spaces, backslash, <br>, and blank lines for new paragraphs β which is why README files, Issues, and Wikis can mix them freely. For more GitHub-specific formatting rules, see GitHub Markdown. Outside GitHub, behavior varies by tool and configuration, so always preview in the actual platform you're publishing to before relying on a specific method.
Line Breaks vs. Paragraph Breaks
They look similar but do different jobs: a line break moves text to the next line within the same paragraph; a paragraph break (blank line) starts an entirely new block of text.
For most documentation, articles, and blog posts, paragraph breaks are the better default β they're what readers expect and what most style guides recommend. Reach for a line break only when specific lines genuinely need to stay visually separate but logically connected β an address, a stanza of a poem, a stack of contact details.
Try These Examples
Address:
MDConvertHub<br>
New Delhi<br>
India
Live Preview
MDConvertHub
New Delhi
India
Contact information:
Email: support@example.com<br>
Website: https://example.com
Live Preview
Email: support@example.com
Website: https://example.com
Poetry:
The sun will rise.<br>
The birds will sing.<br>
A brand new day begins.
Live Preview
The sun will rise.
The birds will sing.
A brand new day begins.
Release notes:
Version 2.0 Released<br>
Performance Improvements<br>
Bug Fixes<br>
New Markdown Features
Live Preview
Version 2.0 Released
Performance Improvements
Bug Fixes
New Markdown Features
Best Practices
- Default to paragraph breaks for normal content β they're more readable and match standard writing conventions.
- Reserve hard breaks and
<br>for genuinely line-sensitive content β addresses, poetry, contact blocks β not regular paragraphs. - Use methods consistently for similar situations β for example, paragraph breaks for normal text throughout, and
<br>for every address block, rather than switching approach for the same type of content without a reason. - Preview on the actual publishing platform before shipping, particularly if you're relying on
<br>or a tool-specific backslash behavior.
Common Mistakes
| Mistake | Fix |
|---|---|
| Pressing Enter once and expecting a new line | Add two trailing spaces, a backslash, or <br> for a visible break |
| Forgetting the trailing spaces (they're invisible) | Check carefully, or switch to the backslash method, which is visible in source |
Stacking multiple <br> tags for extra spacing |
Use a paragraph break instead β cleaner and more maintainable |
| Using different methods for the same type of content without a reason | Use one consistent approach for similar formatting situations |
Frequently Asked Questions
- 1
How do I create a line break in Markdown?
Add two trailing spaces then press Enter, end the line with a backslash (CommonMark), or use the HTML <br> tag where your platform supports inline HTML. Use a blank line instead if you actually want a new paragraph.
- 2
Why isn't my line break working?
Usually one of three things: you pressed Enter only once (a soft break, not a hard one), you forgot the two trailing spaces, or your platform doesn't allow inline HTML so <br> isn't rendering. Try the backslash method, or confirm HTML support before relying on <br>.
- 3
Which method should I use?
Blank line for normal paragraphs, two trailing spaces for traditional Markdown syntax, backslash for CommonMark-compatible documents, and <br> when your platform supports inline HTML and you need an explicit break.
- 4
What's the difference between a line break and a paragraph break?
A line break keeps text in the same paragraph but moves it to the next line. A paragraph break starts a genuinely new paragraph via a blank line. Most long-form writing should use paragraph breaks.
- 5
Does GitHub support all these methods?
Yes β GitHub Flavored Markdown supports two trailing spaces, backslash, <br>, and blank-line paragraphs, all in the same document.
- 6
Should I use <br> or two trailing spaces?
Either works. Two spaces follows traditional Markdown syntax. <br> is easier to spot in source than invisible trailing spaces, but confirm your platform allows inline HTML before relying on it.
- 7
Is it fine to use multiple <br> tags for extra spacing?
It works where HTML is supported, but a paragraph break is usually cleaner and easier to maintain β reserve stacked <br> tags for cases where a new paragraph genuinely isn't appropriate.
