The line break is a new blank line added to the generated HTML as well as rendered a new line on the webpage.

How does line break add to markdown content?

Markdown line break

There are multiple ways to add blank lines to markdown content.

Since Markdown is a text-to-HTML tool and if the parser supports HTML output, You can add HTML tags to it.

  • Use HTML br tag directly in markdown content


Uses to break new lines in HTML.

<br/>

This adds a single new blank line to the page.

If you want multiple lines, Adding multiple tags still produces a single line.

This does not generate 2 blank lines

<br/>
<br/>

The above two line breaks treat as a single line break in Markdown.

To add multiple lines, Use the <pre> tag to preserve line break. The content inside pre tag is not parsed, so, just add empty blank lines as seen below

<pre>




</pre>

Sometimes, You want to add images to the README.md file. It includes a screenshot of images.

  • Use non-breaking space

Another way is to use &nbsp; in place of new blank lines.

To add two blank lines, add below

line1
&nbsp;
&nbsp;
line2

It creates two blank lines However, Some markdown providers such as Bitbucket do not support this.

  • Use the backslash

backslash(\) symbol adds to the content to create a line break.

line 1
\
\
\
line 2

Generated Output is

<p>
line 1
<br>
<br>
<br>
line 2</p>
  • use two empty spaces

Another way is to add two or more spaces to add line breaks in markdown content

line start

line end

How to add line break to markdown Bitbucket

There are multiple ways to add a blank line in markdown content in Bitbucket issues or comments.

First way, using <br> HTML tag inside markdown content.

Statement1
<br/><br/>
Statement2

Generated HTML

<p>
Statement1
<br/><br/>
Statement2
</p>

Second way, use two spaces with entering or enter keystroke in markdown content and add link break.

line1

line2

The third way, use a hyphen(-) in markdown content.

line one
-
line two

Line break in GitHub Markdown

Markdown content in GitHub used in comments, issues, and README.md files.

Multiple ways to add a new line to markdown content on GitHub

First way, use <br/> tag

line1
<br/>
line2

Render as

line1

line2

The second way, use ASCII non-breaking spaces &nbsp;.

line1
&nbsp;
line2

The third way, use the backslash(\)

line1
\
line2

The fourth way, use two spaces with entering or returning keystrokes.

line1

line2