Markdown 换行与分段
Markdown 会把相邻的几行合成一个段落。在行尾写一个反斜杠就会在这里换行,空一行则开始新的段落。
简短回答
Markdown 怎么换行?
在行尾写一个反斜杠 \,然后在下一行接着写。行尾加两个空格效果相同,允许 HTML 的地方也可以用 <br>。单独按一次回车只会显示成一个空格,空一行才是新段落。
Markdown
床前明月光,\
疑是地上霜。
空一行开始新的段落。显示效果
床前明月光,
疑是地上霜。
空一行开始新的段落。
换行的写法和示例
段落内换行有三种写法,另外还有开始新段落的写法。
只按一次回车会被合并
相邻的几行会合成一个段落,换行的位置变成一个空格。中文之间也可能多出这个空格,具体取决于浏览器。
Markdown
床前明月光,
疑是地上霜。显示效果
床前明月光, 疑是地上霜。
行尾加反斜杠
在行尾写一个反斜杠就会强制换行。反斜杠在源码里看得见,编辑器不会把它删掉。
Markdown
床前明月光,\
疑是地上霜。显示效果
床前明月光,
疑是地上霜。
行尾加两个空格
行尾加两个或更多空格也会换行。这里的空格在逗号后面,看不见,很多编辑器保存时还会自动删掉。
Markdown
床前明月光,
疑是地上霜。显示效果
床前明月光,
疑是地上霜。
<br> 标签
允许 HTML 的地方,<br> 可以在任何位置换行,表格单元格里也可以。
Markdown
第一行<br>第二行
| 地址 |
| --- |
| 北京市海淀区<br>中关村大街 1 号 |显示效果
第一行
第二行
| 地址 |
|---|
| 北京市海淀区 中关村大街 1 号 |
新的段落
空一行开始新段落,段落之间的距离比换行大。
Markdown
第一段。
第二段。显示效果
第一段。
第二段。
增加段落之间的空白
连续多个空行只算一个。要增加空白,可以单独一行写 或 <br>。
Markdown
下面有三个空行。
它们只留下一个间距。
上面单独写了 ` ` 的一行留出了明显的空白。显示效果
下面有三个空行。
它们只留下一个间距。
上面单独写了 的一行留出了明显的空白。
各平台的换行规则
有些应用会按输入显示每一次换行,有些遵循 Markdown 规则把几行合并。
| 应用 | 支持情况 | 说明 |
|---|---|---|
| GitHub | 有差异 | Issue、PR 和评论会保留每次换行;Markdown 文件需要反斜杠、两个空格或 <br>。 |
| Obsidian | 支持 | 默认每次换行都会显示,在设置中开启“严格换行”后才会合并。 |
| Discord / Slack | 支持 | 每次换行都会显示,按 Shift+Enter 换行而不发送。 |
| Notion | 支持 | Shift+Enter 在块内换行,Enter 开始新块。 |
| VS Code 预览 | 有差异 | 默认合并单次换行,开启 markdown.preview.breaks 设置后保留。 |
常见问题
为什么 Markdown 不认我的换行?
段落里单独的一次换行会被当成空格,这样源码里的长句可以随意折行。在行尾加反斜杠或两个空格,换行就会保留。
哪种换行写法最好?
行尾反斜杠。它属于 CommonMark 和 GitHub 风格 Markdown,而且在源码里看得见。行尾两个空格容易丢失,
<br> 只在允许 HTML 的地方有效。表格单元格里怎么换行?
在单元格里写
<br>。直接按回车会结束这一行表格。怎样增加段落之间的空白?
多余的空行会被忽略。在段落之间单独写一行
或 <br>。为什么 GitHub 评论里能换行,README 里不行?
GitHub 在 Issue、Pull Request 和评论中保留每次换行,Markdown 文件则遵循标准规则。在文件里请用反斜杠或两个空格换行。
列表项里怎么换行?
在行尾加反斜杠或两个空格,下一行缩进到和列表项文字对齐。
输入 \n 能换行吗?
\n 能换行吗?不能。Markdown 会把反斜杠加
n 原样显示成这两个字符。请按回车,再用上面的方法换行。