Markdown Paragraphs

A paragraph is one or more lines of text grouped together.

To start a new paragraph in Markdown, leave one blank line between blocks of text.

Example

This is the first paragraph.

This is the second paragraph.

Output

If you're new to Markdown overall, read Markdown Basics first — this page focuses only on paragraph formatting, not headings, lists, or other syntax.

The easiest way to create paragraphs is by pressing Enter twice.

Example

Markdown is easy to learn.

It is widely used for documentation.

It also works well for README files.

Output

Many beginners think pressing Enter once creates a new paragraph.

It doesn't.

Example

This is line one.
This is line two.

Most Markdown editors render this as:

To create a new paragraph, add an empty line.

Correct

This is line one.

This is line two.

Sometimes you don't want a new paragraph — you only want a new line.

Markdown supports several ways to create line breaks.

Method 1 — Two spaces (recommended)

Add two spaces at the end of a line before pressing Enter.

First line··
Second line

(The dots represent two trailing spaces.)

Output

Method 2 — HTML <br>

Some Markdown applications support HTML.

First line<br>
Second line

Output

Use HTML line breaks only when necessary. For the full line-break rules in context, see Markdown Syntax.

Paragraphs can also be added inside list items.

Example

- First item

  This paragraph belongs to the first item.

- Second item

This improves readability in long lists.

Paragraphs work inside blockquotes as well.

> First paragraph.
>
> Second paragraph.

Output

Keep paragraphs separate from code blocks by leaving a blank line.

Good structure

Install the package.

Add your command in a fenced code block:

npm install

Then continue with the next paragraph:

Run the application.

This structure is much easier to read than running prose directly into a fenced code block.

Follow these recommendations for cleaner documents.

• Keep paragraphs short.
• Focus on one idea per paragraph.
• Leave a blank line between paragraphs.
• Avoid very long text blocks.
• Use headings to separate larger sections.
• Combine paragraphs with lists when explaining steps.

Short paragraphs improve readability on both desktop and mobile devices.

Missing blank line

Incorrect

First paragraph.
Second paragraph.

Correct

First paragraph.

Second paragraph.

Using too many blank lines

Avoid

Paragraph one.



Paragraph two.

Use only one blank line between paragraphs.

Using HTML everywhere

Although HTML works in many Markdown editors, prefer native Markdown whenever possible.

Instead of relying on <br> tags everywhere, use proper paragraphs and spacing.

Paragraph syntax works consistently across nearly every Markdown application.

Platform	Paragraph Support
GitHub	✅
GitLab	✅
VS Code	✅
Obsidian	✅
Notion	✅
Discord	✅
Reddit	✅

Good Markdown isn't only about syntax — it's also about presentation.

Try to:

• Write short paragraphs.
• Keep sentences simple.
• Break long explanations into multiple sections.
• Use headings frequently.
• Add lists where appropriate.

These small improvements make documentation much easier to read.

Continue learning Markdown with these guides:

Available now

• Markdown Basics — core concepts for beginners
• Markdown Cheat Sheet — quick syntax lookup
• Markdown Syntax — complete reference with examples
• Markdown Headings — H1 through H6 structure
• Markdown Lists — ordered, unordered, nested, and task lists
• Markdown Links — inline, reference, and relative links
• Markdown Images — syntax, URLs, alt text, and GitHub paths
• Markdown Tables — syntax, alignment, and GitHub GFM

Coming soon to MDConvertHub Docs

• Markdown Code Blocks

The easiest way to understand Markdown paragraphs is by experimenting. Open the Markdown Editor and try creating paragraphs, line breaks, blockquotes, and lists.