Markdown Line Breaks: New Lines, Paragraphs, and Table Cells

To start a new line inside a Markdown paragraph, put a backslash at the end of the first line, then press Enter. To start a separate paragraph, leave a blank line. These produce different document structures, which matters when you later export a README, address, or report to Word.

Documentation team\
42 Example Street\
Portland, OR

The address stays in one paragraph with three displayed lines. Paste it into the Markdown preview to compare it with the examples below.

Pick the Kind of Break You Need

A line break does not create a page break. If the next section needs a new sheet in an exported document, see the separate Markdown page-break guide.

Why Pressing Enter Can Look Like a Space

Try this source:

The draft is ready.
The reviewer can open it today.

In this site's preview, both sentences belong to one paragraph and flow together. The newline remains useful in the source file, but does not force the browser to start a new displayed line. The browser can still wrap the text according to the available width.

Now insert an empty line:

The draft is ready.

The reviewer can open it today.

The preview produces two paragraphs. Use this version when the second sentence begins a new thought. Adding several empty lines is not a reliable way to request extra vertical spacing; paragraph styling belongs to the renderer or document template.

Backslash or Two Trailing Spaces

CommonMark defines two spaces before a newline and a backslash before a newline as hard-break syntax inside a paragraph. The CommonMark hard-line-break examples document both forms.

The backslash version is visible when reviewing a file:

Prepared by the documentation team\
Reviewed by the release manager

The alternative is to type exactly two spaces after team, then press Enter. Those spaces are invisible in many editors and may be removed by automatic trailing-whitespace cleanup. If a break disappears after saving, inspect whitespace settings or use the backslash version.

Do not type the two characters \n into ordinary prose and expect a break. That is a programming-string convention, not a Markdown newline. Also avoid putting a backslash at the very end of a paragraph: a hard break needs another line of paragraph content after it.

GitHub Comments and README Files Behave Differently

GitHub's line-break documentation distinguishes repository .md files from issues, pull requests, and discussions. Ordinary newlines can display as breaks in those conversation surfaces, while a README needs explicit hard-break syntax.

That difference explains why text copied from an issue can look different in a README. Review the destination file, rather than assuming that every surface on the same website uses identical formatting rules.

Keep a Continuation Inside a List Item

Indent the continuation to match the beginning of the item text:

- Release notes\
  Include the migration instructions.
- Installation guide

Here, the first item contains two displayed lines. The second item remains separate. For a separate paragraph within the first item, use a blank line and keep the continuation indented:

- Release notes

  Include the migration instructions and known issues.
- Installation guide

The indentation guide covers numbered lists, nested bullets, and code inside an item.

Add a New Line in a Markdown Table Cell

A GFM table row belongs on one source line. Pressing Enter inside its contents can split the row. In renderers that allow HTML line breaks, use this pattern:

| Document | Owners |
| --- | --- |
| Release notes | Writer<br>Reviewer |

This site's preview supports this example. A destination that strips HTML might remove the break or show the tag, so check that platform before adopting it throughout a document. A list outside the table is often easier to maintain when a cell needs several paragraphs.

Use the Markdown table generator for tabular data, and the table syntax guide for alignment and escaped pipes.

Check the Exported Document

Before using the Markdown to Word converter, test a short sample containing one ordinary newline, one explicit hard break, and one blank line. The preview should show one flowing paragraph, a forced line break, and two separate paragraphs respectively.

Open the downloaded DOCX and inspect the address, lists, and table. Page width and Word's paragraph styles can change wrapping even when the underlying breaks are correct. Fix the Markdown structure first; adjust final typography in Word when a particular document template requires it.