Line Breaks
This page describes when to add line breaks and when to not add line breaks in Markdown.
When to add an empty line break
Markdown may not format your content properly if an empty line break is not added. To avoid this scenario and to make content easy for users to read, put an empty line break before and after any of the following content:
- Admonition syntax
- Bulleted and numbered lists
- Code blocks
- Headings
- Images
- Paragraphs
- Tables
In addition, be sure to add an empty line at the end of the file. Although modern static-site generators don't require a new line, adding a new line is standard practice in source code.
When to not add a line break
Don't add a line break after each sentence.
Although static-site generators will properly format the paragraph if the sentences each of a single line break, The line breaks break up the flow of the paragraph and may cause confusion about whether the sentence actually belongs in the paragraph.