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.

Open EditorDownload PDF

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) ❌ CommonMark-compatible documents
Blank line βœ… βœ… Normal paragraphs
HTML <br> βœ…, where supported ❌ 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. 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. 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. 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. 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. 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. 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. 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.