The Dead Simple Markdown Guide to Line Breaks

20 Aug 2024

Line Breaks

To create a line break or new line (<br>), end a line with two or more spaces, and then type return.

Markdown	HTML	Rendered Output
`This is the first line.` `And this is the second line.`	`<p>This is the first line.<br>` `And this is the second line.</p>`	This is the first line. And this is the second line.

Line Break Best Practices

You can use two or more spaces (commonly referred to as “trailing whitespace”) for line breaks in nearly every Markdown application, but it’s controversial. It’s hard to see trailing whitespace in an editor, and many people accidentally or intentionally put two spaces after every sentence. For this reason, you may want to use something other than trailing whitespace for line breaks. If your Markdown application supports HTML, you can use the <br> HTML tag.

For compatibility, use trailing white space or the <br> HTML tag at the end of the line.

There are two other options I don’t recommend using. CommonMark and a few other lightweight markup languages let you type a backslash (\) at the end of the line, but not all Markdown applications support this, so it isn’t a great option from a compatibility perspective. And at least a couple lightweight markup languages don’t require anything at the end of the line — just type return and they’ll create a line break.

✅ Do this	❌ Don't do this
`First line with two spaces after.` `And the next line.` `First line with the HTML tag after.<br>` `And the next line.`	`First line with a backslash after.\` `And the next line.` `First line with nothing after.` `And the next line.`

This guide is a Matt Cone project available on Markdown Guide under the CC BY-SA 4.0 license.

← Previous

The Dead Simple Markdown Guide to Paragraphs

Up Next →

The Dead Simple Markdown Guide to Emphasis