Back to Syntax Hub

Line Breaks in Markdown Tables

Markdown tables do not support literal newlines inside cells because each row in a Markdown table must reside on a single text line. To break text onto multiple lines, use the HTML <br> tag.

The <br> Solution

Insert <br> wherever you want a line break. Most Markdown parsers (GitHub, GitLab, Obsidian, Pandoc) render this as a visual line break inside the cell.

Markdown Syntax
| Step | Instructions |
| :--- | :----------- |
| 1    | Clone repo<br>Run `npm install`<br>Start dev server |
| 2    | Open browser at localhost:3000 |
Rendered Result
StepInstructions
1Clone repo
Run npm install
Start dev server
2Open browser at localhost:3000

Build Multi-Line Markdown Tables Easily

Use our free visual editor to insert line breaks and format cells without breaking columns.

Open Generator