Blog

A blank line starts a new paragraph

A markdown new line is one of two things.


title: “Markdown New Line: How to Break a Line or Start a Paragraph” slug: markdown-line-break meta_description: “One Enter does not start a new line in Markdown. Use two spaces, a trailing backslash, or
. A blank line starts a new paragraph.” target_keyword: primary: “markdown new line” secondary: “markdown line break” search_data: “Ahrefs US, Nov 12 2026. Primary: markdown new line, 2,000/mo, KD 4. Secondary: markdown line break, 1,100/mo, KD 3. Both sit under the parent topic markdown link, traffic potential about 23,000–24,000. No existing page on markdownwriter.com targets these queries. /markdown-cheatsheet/ is a reference tool and keeps its own keywords; this post links to it.” suggested_internal_links: from_this_post: - “https://markdownwriter.com/markdown-cheatsheet/#commonmark-line-breaks” - “https://markdownwriter.com/editor/” - “https://markdownwriter.com/markdown-to-html/” - “https://markdownwriter.com/markdown-to-plain-text/” - “https://markdownwriter.com/markdown-table-generator/” - “https://markdownwriter.com/discord-text-formatter/” - “https://markdownwriter.com/markdown-to-slack/” link_back_once_published_at: “https://markdownwriter.com/blog/markdown-line-break/” pages_that_should_link_here: - page: “https://markdownwriter.com/markdown-cheatsheet/#commonmark-line-breaks” where: “The Line breaks and new lines card. It already states the rule in four notes. A link from those notes is the short version of this post.” - page: “https://markdownwriter.com/markdown-table-generator/” where: “The FAQ answer that starts ‘Does it support multiline cells’. It tells people a cell is one line of inline markdown. Link the table-cell section of this post from that answer.” - page: “https://markdownwriter.com/markdown-to-plain-text/” where: “The FAQ answer ‘Will the line breaks survive?’. It already distinguishes paragraph breaks, forced breaks, and soft breaks.” - page: “https://markdownwriter.com/markdown-to-html/” where: “Anywhere the page shows a paragraph becoming

or a forced break becoming
. Readers comparing the two land there next.” posting: “Standalone draft for the Markdown Writer blog. The blog is posted by hand. This file is not a route, not in the sitemap, and not wired into the app.”

A markdown new line is one of two things. A line break stays inside the paragraph: end the line with two spaces, or with a backslash (\), or use a <br> tag where HTML is allowed. A blank line ends the paragraph and starts the next one, usually with more space above it. A single Enter is neither. The two lines stay one paragraph, and the break shows up as a space.

Use a line break for an address or a verse. Use a new paragraph for the next thought. The markdown cheatsheet keeps the short form of this rule.

A blank line starts a new paragraph

A paragraph is one or more consecutive lines. Wrap a long paragraph in the source wherever you like. Leave an empty line before the next one.

The first paragraph
can wrap in the source.

The second paragraph starts after a blank line.

CommonMark turns that into two paragraphs. The single newline inside the first one is a soft break:

<p>The first paragraph
can wrap in the source.</p>
<p>The second paragraph starts after a blank line.</p>

On screen those two source lines are one line of text. Markdown to HTML shows the <p> tags. Markdown to plain text keeps the blank line and folds the soft wrap into a space. A renderer may also turn every soft break into a hard break. That option is why a GitHub comment and a README disagree about Enter.

Two trailing spaces

End the line with two or more spaces, then press Enter. In the sample, each · is a space. Those spaces are the syntax.

221B Baker Street··
London
<p>221B Baker Street<br />
London</p>

This is the original Markdown rule, and CommonMark kept it. The spaces are invisible, so a broken line and a wrapped line look the same until the editor shows whitespace. A save that trims trailing whitespace deletes them. A break with no text after it does not add a blank line under the paragraph.

A trailing backslash

The markdown line break you can see is a \ at the end of the line, with nothing after it.

221B Baker Street\
London
<p>221B Baker Street<br />
London</p>

Same rendered paragraph as the two spaces. The marker is visible, so a space-trimmer leaves it alone. GitHub and GitLab document it for Markdown files. The original syntax has no backslash break, and Python-Markdown (MkDocs) and old Reddit do not treat it as one. A \ before punctuation is still an escape (\* is a literal asterisk). The break is only a backslash at the end of the line.

A <br> tag

A break tag is the same element the parser would have emitted, written by hand.

221B Baker Street<br>
London

CommonMark passes an ordinary inline tag through, and GitHub’s writing docs list <br> for a .md file. Hugo skips raw HTML unless markup.goldmark.renderer.unsafe is true (the default is false). Notion’s API markdown stores tags such as <div> as text. Discord’s formatting guide does not list HTML. In a CommonMark paragraph, the backslash is enough. The tag matters in a table cell, where a newline would end the row.

What each platform does

Enter can insert a real break and the renderer can still be CommonMark: the spec allows soft breaks to be shown as hard breaks. Each row is from that product’s own docs.

Platform One newline Forced break
CommonMark Soft break, shown as a space Two or more spaces, or \
GitHub .md files Lines join Two spaces, \, or <br>
GitHub issues, PRs, discussions Shown as a break A blank line is still a paragraph
GitLab One paragraph, including comments Two or more spaces, or \
Obsidian Strict on: Enter joins. Off: single breaks show Two or more spaces, or Shift+Enter
Notion app Enter starts a block Shift+Enter
Notion-flavored Markdown API text, separate from the app Trailing \. Empty paragraph: <p />. <br /> in cells
Reddit Lines join. Extra blank lines add no gap Two spaces. \ on www.reddit.com only
Slack mrkdwn Not Markdown \n in the posted text
Discord A typed line stays a line. The guide skips two spaces and \ Shift+Enter, for a mobile external keyboard
Jupyter Original Markdown. HTML is allowed Two or more spaces, or <br>
Hugo hardWraps off by default Two spaces or \. <br> needs unsafe: true
MkDocs Python-Markdown, no nl2br by default Two spaces, or nl2br for every newline

Sources: CommonMark hard breaks and soft breaks, GitHub, GitLab, Obsidian syntax and settings, Notion shortcuts and API markdown, Reddit, Slack, Discord formatting and keyboard note, Jupyter and the original syntax, Hugo, MkDocs, and Python-Markdown nl2br.

A GitHub issue, pull request, or discussion breaks on Enter. A README.md joins those lines. Discord keeps inserted newlines, and Slack’s posted mrkdwn uses \n. Discord text formatter and Markdown to Slack rewrite a file for those chats. In Obsidian, Strict line breaks on joins a bare Enter. The settings page says turning it off shows single breaks, and Shift+Enter inserts one in either mode. A file on GitHub still follows CommonMark after you sync.

Tables and lists

A GFM table cell is inline text. A newline starts the next row, so this leaves London outside the cell:

| Name | Address |
| --- | --- |
| Ada | 12 Market Street
London |

Keep the cell on one line:

| Name | Address |
| --- | --- |
| Ada | 12 Market Street<br>London |

The markdown table generator builds that kind of table. Type the <br> into the cell. On Hugo the tag renders when renderer.unsafe is on. The two-space break needs a newline, and that newline would end the row.

A hard break inside a list item leaves the list tight. Indent the next line to the text:

- 221B Baker Street\
  London
- Next item

A blank line between items makes the list loose, and each item becomes its own paragraph, with more space. Use that blank line for the space. Use the backslash when the address is all that should wrap.

A second paragraph in one item needs a blank line and an indent. Without the indent, the paragraph ends the list.

- First line of the item.

  Second paragraph, still in the item.

- Next item

Where the break goes missing

Trailing spaces get trimmed. They are the syntax, and they are invisible. A save that trims trailing whitespace, or a cleanup that deletes “stray” spaces, removes the break and leaves no mark. Prefer \ in a shared file, and show whitespace while a file still uses two spaces.

Prettier reflows lines. proseWrap defaults to preserve because some sites treat a newline as meaningful. The docs name GitHub comments and Bitbucket. always wraps to the print width. never puts the paragraph on one line: fine for a CommonMark file, wrong for a GitHub issue. A \ is still visible after the format.

Extra blank lines collapse. Several blank lines are still one paragraph break. Obsidian points to &nbsp; or <br> for space that should remain. Reddit documents the same limit, and a paragraph that contains only a non-breaking space. On your own site, set the gap with paragraph margin.

The marker has to have text after it. Thanks\ at the end of a paragraph prints the backslash. Two spaces at the end of a paragraph are discarded. Inside a code span, both markers stay as code. Put the break between two bits of text, outside the backticks.

The editor uses the same parser as the HTML converter, so you can check a backslash, two spaces, or a <br> against a plain newline.

FAQ

Why is my line break not showing on GitHub?

In an issue, pull request, or discussion, Enter already breaks the line. In a .md file, those lines join. End the first line with \, two spaces, or <br>. If the spaces were saved and the break is gone, a trimmer deleted them. A marker with no text after it is dropped as well.

How do I add a blank line or extra space?

One blank line is one paragraph break. Another blank line under it adds no more gap. For a blank-looking line inside a paragraph, use <br> where HTML is allowed. Obsidian and Reddit both document a paragraph of only &nbsp; when the renderer would collapse the gap. On your own site, increase the paragraph margin.

How do I break a line inside a table or a list?

In a table, stay on one source line and put <br> at the break. A newline splits the row. In a list, \ or two spaces breaks the item’s line. A blank line plus an indent starts a second paragraph in that item.

Does a trailing backslash work everywhere?

It works in CommonMark, GitHub files, GitLab, and Notion’s API markdown. Old Reddit and MkDocs (unless you enable nl2br) want two spaces. Jupyter’s docs describe original Markdown and HTML. Slack’s posted text uses \n. A GitHub comment already breaks on Enter.