返回博客
教程
Markdown 换行
Markdown 新行
Markdown 添加新行
格式设置

Markdown 换行:新行、段落与表格单元格

使用反斜杠、两个空格或空行在 Markdown 中换行。导出 Word 前,解决 README、列表和表格单元格中的换行问题。

5 分钟阅读Markdown to Word 团队

要在 Markdown 段落内部另起一行,请在第一行末尾加上反斜杠,然后按 Enter。要开始一个独立段落,请留一个空行。这两种写法会形成不同的文档结构,之后将 README、地址或报告导出为 Word 时,这一点很重要。

文档团队\
示例街 42 号\
俄勒冈州波特兰市

这个地址仍属于同一段落,但显示为三行。将它粘贴到 Markdown 预览工具中,与下方示例进行比较。

选择所需的换行方式

预期效果Markdown 源码常见用途
延续同一段落一个普通换行将较长的源码行拆开
在同一段落内另起一行反斜杠后按 Enter地址和短诗
开始一个新段落一个空行分隔文章中的不同观点
在表格单元格内换行在支持 HTML 的环境中使用 <br>在一个单元格内放两个简短标签

换行不会产生分页。如果导出文档的下一节需要从新的一页开始,请参阅单独的 Markdown 分页指南

为什么按 Enter 后看起来像一个空格

试试这段源码:

草稿已准备好。
审阅者今天就可以打开它。

在本站的预览中,两句话属于同一段落,会连续排版。源码文件中的换行仍有助于阅读,但不会强制浏览器另起一行显示。浏览器仍会根据可用宽度自动折行。

现在插入一个空行:

草稿已准备好。

审阅者今天就可以打开它。

预览会生成两个段落。如果第二句话开始表达一个新想法,就使用这种写法。添加多个空行并不能可靠地增加垂直间距;段落样式应由渲染器或文档模板决定。

反斜杠或两个行尾空格

CommonMark 将换行符前的两个空格,以及换行符前的反斜杠,都定义为段落内部的硬换行语法。CommonMark 硬换行示例记录了这两种形式。

使用反斜杠时,审阅文件的人可以直接看到换行标记:

由文档团队编写\
由发布负责人审阅

另一种方法是在 编写 后准确输入两个空格,再按 Enter。许多编辑器不会显示这些空格,而且自动清理行尾空白的功能可能会将它们删除。如果保存后换行消失,请检查空白字符设置,或改用反斜杠写法。

不要在普通正文中输入 \n 这两个字符并期待换行。这是编程语言字符串中的约定,并不是 Markdown 的换行方式。也要避免在段落的最末尾加反斜杠:硬换行之后必须还有同一段落的下一行内容。

GitHub 评论和 README 文件的表现不同

GitHub 的换行文档区分了仓库中的 .md 文件,以及议题、拉取请求和讨论。在这些交流界面中,普通换行可能会直接显示为换行,而 README 需要明确的硬换行语法。

这解释了为什么从议题中复制的文本放到 README 里后,显示效果可能不同。请检查目标文件,不要假定同一网站的所有界面都使用完全一致的格式规则。

将续行保留在列表项内

将续行缩进到与该列表项正文开头对齐的位置:

- 发布说明\
  包含迁移指引。
- 安装指南

这里,第一个列表项显示为两行,第二个列表项仍然独立。要在第一个列表项内另起一个段落,请添加空行,并让后续内容继续保持缩进:

- 发布说明

  包含迁移指引和已知问题。
- 安装指南

缩进指南介绍了编号列表、嵌套项目符号列表,以及列表项内的代码。

在 Markdown 表格单元格内换行

GFM 表格的一行应写在同一源码行上。在内容中按 Enter 可能会拆断这一行。在允许 HTML 换行的渲染器中,可采用以下写法:

| 文档 | 负责人 |
| --- | --- |
| 发布说明 | 编写者<br>审阅者 |

本站预览支持这个示例。会清除 HTML 的目标平台可能会删除换行,或直接显示标签,因此在整篇文档中采用这种写法前,请先检查该平台。当一个单元格需要包含多个段落时,将内容写成表格之外的列表通常更容易维护。

处理表格数据时,可使用 Markdown 表格生成器;了解对齐方式和竖线转义时,可参阅表格语法指南

检查导出的文档

使用 Markdown 转 Word 转换器之前,先测试一个简短样例,其中分别包含一个普通换行、一个明确的硬换行和一个空行。预览应依次显示为连续排版的同一段落、强制换行,以及两个独立段落。

打开下载的 DOCX,检查地址、列表和表格。即使底层换行结构正确,页面宽度和 Word 的段落样式仍可能改变文字的折行位置。先修正 Markdown 结构;当特定文档模板有要求时,再在 Word 中调整最终排版。

相关文章