Skip to content

段落和换行

段落和换行是 Markdown 文档的基础构建块。掌握正确的段落和换行语法能让你的文档结构清晰、易读。

段落语法

在 Markdown 中,段落就是连续的文本行。要创建段落,只需要用空行分隔文本即可。

基本段落

markdown
这是第一个段落。这个段落包含多个句子。
所有这些句子都属于同一个段落。

这是第二个段落。它与第一个段落之间
有一个空行分隔。

这是第三个段落。

渲染效果

这是第一个段落。这个段落包含多个句子。 所有这些句子都属于同一个段落。

这是第二个段落。它与第一个段落之间 有一个空行分隔。

这是第三个段落。

换行语法

Markdown 提供两种方式实现换行:

1. 硬换行(强制换行)

在行尾添加两个或更多空格,然后按回车键:

markdown
这是第一行。  
这是第二行。

渲染效果

这是第一行。
这是第二行。

2. 软换行(自然换行)

使用空行分隔,创建新的段落:

markdown
这是第一段。

这是第二段。

渲染效果

这是第一段。

这是第二段。

换行的不同方法对比

方法语法HTML 输出使用场景
段落分隔空行<p>...</p>逻辑分段
硬换行行尾两个空格<br>诗歌、地址
HTML 换行<br><br>精确控制

示例对比

段落分隔

markdown
第一段内容。

第二段内容。

硬换行

markdown
第一行内容。  
第二行内容。

HTML 换行

markdown
第一行内容。<br>
第二行内容。

常见问题和解决方案

1. 无意的连接

问题:两行文本意外地连接在一起

markdown
这是第一行
这是第二行  ← 这两行会被合并为一段

解决方案:使用空行或行尾空格

markdown
这是第一行

这是第二行  ← 现在是两个段落

或者

这是第一行  
这是第二行  ← 现在是硬换行

2. 意外的换行

问题:不想要的换行出现

markdown
这是一个很长的
句子被意外分开了

解决方案:确保文本在同一行或使用正确的换行语法

markdown
这是一个很长的句子,应该在同一段落中。

或者明确使用换行:
这是一个很长的  
句子,这里是有意的换行。

3. 空格问题

问题:行尾空格不可见,容易遗忘

解决方案

  • 配置编辑器显示空白字符
  • 使用支持 Markdown 的编辑器
  • 使用 HTML <br> 标签作为替代

特殊情况处理

诗歌和歌词

使用硬换行保持每行独立:

markdown
静夜思  
床前明月光,  
疑是地上霜。  
举头望明月,  
低头思故乡。

渲染效果

静夜思
床前明月光,
疑是地上霜。
举头望明月,
低头思故乡。

地址和联系信息

markdown
联系地址:  
北京市海淀区  
中关村大街1号  
邮编:100000

或者使用 HTML:

联系地址:<br>
北京市海淀区<br>
中关村大街1号<br>
邮编:100000

代码注释

markdown
/* 这是一个多行注释  
   每行都有特定的缩进  
   需要保持格式 */

最佳实践

1. 保持一致性

在整个文档中保持一致的段落和换行风格:

markdown
✅ 推荐:统一使用空行分段
第一段内容。

第二段内容。

第三段内容。

❌ 不推荐:混合使用不同方法
第一段内容。

第二段内容。  
第三段内容。

2. 避免过多的硬换行

markdown
✅ 推荐:让长句自然流动
这是一个很长的句子,包含了很多信息,应该让它自然地在段落中流动。

❌ 不推荐:不必要的硬换行
这是一个很长的句子,  
包含了很多信息,  
不需要这样分行。

3. 使用语义化分段

markdown
✅ 推荐:按逻辑分段
## 问题描述

用户反映系统登录缓慢。经过初步调查,发现数据库连接池配置可能存在问题。

## 解决方案

调整数据库连接池参数,增加最大连接数并优化连接超时设置。

❌ 不推荐:随意分段
## 问题描述

用户反映系统登录缓慢。

经过初步调查。

发现数据库连接池配置可能存在问题。

编辑器配置

Visual Studio Code

显示空白字符:

json
{
  "editor.renderWhitespace": "all",
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true
}

Typora

启用显示空白字符:

  • 偏好设置 → 编辑器 → 显示空白字符

Vim

显示空白字符:

vim
:set list
:set listchars=space:·,trail:·,eol

HTML 输出

Markdown 段落和换行转换为 HTML:

markdown
段落1

段落2

转换为:

html
<p>段落1</p>
<p>段落2</p>
markdown
行1  
行2

转换为:

html
<p>行1<br>
行2</p>

相关语法

练习

尝试创建以下内容:

  1. 三个不同主题的段落
  2. 一首短诗(使用硬换行)
  3. 一个包含联系信息的地址块
  4. 一个混合段落和换行的复杂文本

完成后检查渲染效果,确保格式符合预期。

由 Markdownlang.com 整理创建