Skip to content
All Markdown syntax

Line breaks in Markdown

Headings and paragraphs

Markdown syntax

Works everywhere
First line\
Second line

A backslash at the end of the line. Visible, so it survives editors that trim spaces.

A single line break in the source is joined into the same paragraph. To break the line without starting a new paragraph, end it with a backslash or two spaces, or use <br>. For a new paragraph, leave a blank line.

All ways to write it

  • First line\
    Second line
    A backslash at the end of the line. Visible, so it survives editors that trim spaces.Works everywhere
  • First line··
    Second line
    Two spaces at the end of the line (shown here as ··). Invisible and easy to lose.Works everywhere
  • First line<br>Second line
    HTML break. Also the way to break a line inside a table cell.Needs HTML
  • First paragraph
    
    Second paragraph
    A blank line starts a new paragraph.Works everywhere

Example

You type

Yamuno\
Support team\
[email protected]

A blank line above starts a new paragraph.

You get

Yamuno
Support team
[email protected]

A blank line above starts a new paragraph.

Questions

Why does pressing Enter not create a new line?

Markdown treats a single newline as a space, so you can wrap long lines in the source. GitHub issue and pull request comments are the exception and keep single newlines.

How do I add a line break inside a table cell?

Use <br>. A real newline would end the table row.

How do I add extra blank space between paragraphs?

Several blank lines collapse into one. Use <br> on its own line, or &nbsp; with blank lines around it.

Line break in Confluence

In a Markdown Macro+ macro, the live preview shows straight away whether a line joined or broke, which is the quickest way to catch trailing spaces your editor removed.

Related syntax

Also in Headings and paragraphs

See all Markdown syntax