Markdown Syntax · Line breaks

Markdown Line Breaks
Why your new line isn't working, and how to fix it

You pressed Enter in your Markdown, but in the rendered output the two lines ran together into one. It's the single most common Markdown surprise — and it's not a bug.

Markdown treats a single newline as a space. So a plain Enter doesn't break the line; it just flows the text on. To actually break a line you have to say so explicitly — and there are three clean ways to do it.

This article shows all three, when to use which, why AI-pasted text often loses its breaks, and how to see the break happen as you type. New to the syntax overall? Start with How to Write Markdown.

Why a plain Enter doesn't break the line

In Markdown, a single line break in the source is a "soft" break — the renderer turns it into a space and keeps the text in the same paragraph. That's deliberate: it lets you wrap long paragraphs in your editor without those wraps showing up in the output.

The catch: when you actually want the line to break, you have to mark it. Here's the same text, unmarked vs marked:

Roses are red,
violets are blue
→ renders as ONE line: "Roses are red, violets are blue"

Roses are red,·· (two trailing spaces here)
violets are blue
→ breaks after "red," (same paragraph)

Line one<br>
line two
→ breaks after "Line one" (visible, reliable)

Paragraph one.

Paragraph two.
→ two separate paragraphs (blank line between)

The three ways to break a line

What you want How to do it Result
Break within a paragraph End the line with two spaces, then Enter Next line, same paragraph (a "hard break")
Break within a paragraph (visible) End the line with a <br> tag or a backslash \ Same result, but you can see it in the source
Start a new paragraph Leave a blank line between the two blocks New paragraph, with more space between

Rule of thumb: use a break (two spaces or <br>) for a tight next line — an address, a line of a poem — and a blank line when it's a genuinely new point. Because the two trailing spaces are invisible and easy to lose, many people just use <br>.

Why AI-pasted text loses its breaks

Paste an answer from ChatGPT or Claude into a Markdown editor and the lines sometimes merge. The reason is the same: the text used single newlines, and Markdown collapses those into spaces.

  • Where you want the breaks to stick, add two trailing spaces, a <br>, or a blank line.
  • If the whole thing became one block, you're missing blank lines between paragraphs — add them back.
  • For keeping AI formatting intact when you save, see How to keep the formatting of an AI answer.

Breaks inside lists and tables

Inside a list item or a table cell, a real Enter will break the structure itself. To break a line within an item or cell, use a <br> tag instead of a newline. For tables specifically — where this comes up a lot — see How to Write Markdown Tables.

See the break as you type with NoteLoom

The frustrating part of line breaks is that you can't tell from the source whether they'll work — trailing spaces are invisible. NoteLoom is an editor that reads and writes local md files right in the browser, and its live view fixes exactly that: it renders the formatting as you type, so a break either shows up or it doesn't, and you fix it on the spot.

To be clear about the boundaries: NoteLoom has no AI and won't rewrite your text for you. It only renders your Markdown live, lets you correct it, and saves it back to your local file.

  • live: type and watch — the surest way to catch a break that didn't take.
  • reading: read-only render, to confirm the final spacing.
  • source: the raw Markdown, to add a <br> or check trailing spaces.

How you use it: open app.noteloom.cc in Chrome / Edge / Arc → mount a local folder → open or create a .md → type in live and watch the breaks → save back to your disk, no cloud, no account.

Common pitfalls

Symptom What happened Fix
Single Enter does nothing Markdown reads one newline as a space Add two trailing spaces, <br>, or a blank line
Trailing spaces got stripped Editor or paste removed the invisible spaces Use <br> or a backslash instead — they survive
Everything became one paragraph No blank lines between blocks Separate blocks with a blank line
A break inside a list/table Pressing Enter breaks the list item or table Use <br> inside the item or cell, not a real newline

Related reading

Markdown not rendering? The common gotchas The diagnostic hub: renderer problem vs syntax slip, with the fix for each. How do you make a horizontal line in Markdown? The other case: a divider across the page (not a line break), plus the --- heading trap. How to Write Markdown? Headings, lists, bold, code blocks — the basic syntax every beginner needs. How do you write Markdown tables? Table syntax, alignment, and line breaks inside cells. How to keep the formatting of an AI answer? Save copied Markdown without the formatting falling apart. What Is Markdown? Understand the format in one line, and why AI so often uses it. Online Markdown Editor Read and write local md files in your browser — see breaks as you type.

FAQ

Why doesn't pressing Enter break the line in Markdown?
Because Markdown treats a single newline as a soft wrap — it renders as a space, so the two lines flow together into one paragraph. To actually break a line you have to signal it explicitly: two spaces at the end of the line, a <br> tag, or a blank line to start a new paragraph.
What's the difference between a line break and a new paragraph?
A line break keeps you in the same paragraph, just on the next line (two trailing spaces or <br>). A blank line starts a new paragraph, which renders with more space between the blocks. Use a break for a tight next line (like an address); use a blank line when it's a genuinely new point.
The two trailing spaces are invisible — is there a more reliable way?
Yes. Since trailing spaces are easy to lose or not notice, many people prefer a <br> tag (or a backslash \ at the end of the line in CommonMark) — both are visible in the source and survive copy-paste better. Pick whichever your editor and target renderer handle consistently.
My AI-pasted text lost its line breaks — why?
The text you pasted probably used single newlines, which Markdown collapses into spaces. When ChatGPT or Claude output is rendered it looks broken up, but the underlying newlines aren't hard breaks. Add two trailing spaces, <br>, or blank lines where you want the breaks to stick.
Can NoteLoom fix line breaks for me?
No — NoteLoom has no AI and won't rewrite your text. What it does give you is a live view that renders the formatting as you type, so you can see immediately whether a line actually broke and fix it yourself. It only displays your Markdown and saves it back to your local file.
Can I do this with NoteLoom on my phone or in Safari?
Not for now. NoteLoom relies on the browser's File System Access API, which currently works in Chromium-based desktop browsers like Chrome, Edge, and Arc; Firefox, Safari, and mobile aren't supported yet.

Stop guessing whether the line broke

Open NoteLoom in Chrome / Edge / Arc, mount a local folder, and type in the live view — the break either shows or it doesn't, so you fix it on the spot. Save back to your disk, no software to install and no account to sign up for.

Open NoteLoom and try it