- HTML 换行：在最终渲染出的 HTML 中，希望
<p>标签内的文本能够换行。 - Markdown 语法换行：在
.md源文件中,如何输入才能实现换行。
下面我将详细解释这两种情况，并提供在 Python 中使用 markdown 库处理它们的方法。
理解 Markdown 的换行规则（核心）
最重要的一点是理解标准 Markdown 的换行规则，这能解决 90% 的问题。
在 Markdown 中，一个换行符（按一次回车）通常不会产生 HTML 的 <br>，它会被视为一个空格,多个连续的换行符也只会被当作一个空格。
要强制换行，你需要在行尾至少添加两个空格，然后再按回车，这被称为 "line break" 或 "hard break"。
示例：
这是第一行，后面有两个空格。 这是第二行，紧挨着第一行。 这是第三段，中间有一个空行。
渲染后的 HTML 效果：
<p>这是第一行，后面有两个空格。<br /> 这是第二行，紧挨着第一行。</p> <p>这是第三段，中间有一个空行。</p>
视觉区别：
- 第一行和第二行：会在同一个
<p>标签内，但第二行会紧跟在第一行后面，因为<br />标签是内联的。 - 第二行和第三行：会被分割成两个独立的
<p>标签，因为中间有一个空行，在浏览器中,这会产生一个明显的段落间距。
在 Python 中使用 markdown 库处理换行
Python 有一个非常流行的库叫 Markdown（通常通过 pip install markdown 安装）,我们来学习如何用它来处理换行。
处理源文件中的两个空格换行
如果你的 Markdown 源文件（ 代码示例： 输出结果： 这是一个更常见的需求：你有一个 Python 字符串，里面用 错误的做法：
直接 正确的做法：
在调用 代码示例： 输出结果： 注意： 如果你只想在代码块内部保留原始的换行符（而不是被 代码示例： html_output = markdown.markdown(md_source, extensions=['fenced_code', 'codehilite']) print(html_output) 可以看到，在代码块 核心要点：.md）中已经遵循了“行尾两个空格”的规则，markdown 库会自动将其转换为 <br />
import markdown
# 这是你的 Markdown 源字符串，包含了行尾的两个空格
md_source = """
这是第一行，后面有两个空格。
这是第二行，紧挨着第一行。
这是第三段。
"""
# 使用 markdown 库进行转换
# extensions 中的 'nl2br' 不是必须的，因为这是默认行为，
# 但明确写出有助于理解
html_output = markdown.markdown(md_source, extensions=['nl2br'])
print("--- Markdown 源 ---")
print(md_source)
print("\n--- 渲染后的 HTML ---")
print(html_output)
--- Markdown 源 ---
这是第一行，后面有两个空格。
这是第二行，紧挨着第一行。
这是第三段。
--- 渲染后的 HTML ---
<p>这是第一行，后面有两个空格。<br />
这是第二行，紧挨着第一行。</p>
<p>这是第三段。</p>将 Python 字符串中的
\n 转换为 HTML 换行\n 表示换行，你希望将这些 \n 转换成 HTML 的 <br />
markdown.markdown(your_string) 是不会把 \n 转换成 <br /> 的，Markdown 会把 \n 当作一个空格处理。markdown.markdown() 之前，先用 str.replace() 将字符串中的 \n 替换成 \n（即在每个换行符前添加两个空格）。import markdown
# 这是一个普通的 Python 字符串，用 \n 表示换行
python_string = "这是第一行\n这是第二行\n\n这是第三段"
# 关键步骤：将 \n 替换为 " \n"
# 这会让 markdown 库识别出这是一个需要换行的地方
md_source_with_line_breaks = python_string.replace('\n', ' \n')
print("--- Python 原始字符串 ---")
print(repr(python_string))
print("\n--- 处理后的 Markdown 源 ---")
print(repr(md_source_with_line_breaks))
# 现在对处理后的字符串进行 Markdown 渲染
html_output = markdown.markdown(md_source_with_line_breaks)
print("\n--- 渲染后的 HTML ---")
print(html_output)
--- Python 原始字符串 ---
'这是第一行\n这是第二行\n\n这是第三段'
--- 处理后的 Markdown 源 ---
'这是第一行 \n这是第二行 \n\n这是第三段'
--- 渲染后的 HTML ---
<p>这是第一行<br />
这是第二行</p>
<p>这是第三段</p>repr() 会显示字符串中的特殊字符，所以你会看到 \n。
其他高级方法（使用扩展）
markdown 库支持扩展,可以改变其默认行为。使用
fenced_code 和 codehilite 扩展<br /> 替换），可以使用 fenced_code 和 codehilite 扩展。import markdown
md_source = """
这是一个普通段落，`单行代码` 中的换行会被忽略。
```python
def hello():
print("第一行")
print("第二行") # 这里的换行会被保留
使用 fenced_code 扩展来支持代码块
**输出结果：**
```html
<p>这是一个普通段落，<code>单行代码</code> 中的换行会被忽略。</p>
<div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">hello</span><span class="p">():</span>
<span class="nb">print</span><span class="p">(</span><span class="s2">"第一行"</span><span class="p">)</span>
<span class="nb">print</span><span class="p">(</span><span class="s2">"第二行"</span><span class="p">)</span> <span class="c1"># 这里的换行会被保留</span>
</code></pre></div><pre><code> 内部,换行符被完整地保留了。
总结与最佳实践
你的需求
Python 实现方法
解释
源文件遵循 Markdown 规范
markdown.markdown(md_source)直接处理，它会自动将
`（行尾两空格）转换为
`。
Python 字符串
\n 换行md_source = my_string.replace('\n', ' \n')html = markdown.markdown(md_source)核心是预处理：把
\n 变成 \n，让 Markdown 能识别。
保留代码块内的换行
markdown.markdown(md_source, extensions=['fenced_code'])使用扩展，让代码块内的换行符被
<pre> 和 <code> 标签保留。
段落间有空行
直接在源字符串中留一个空行即可。
Markdown 会自动将一个或多个空行解析为段落分隔符（
</p><p>）。
\n，只认行尾两个空格。.replace('\n', ' \n') 进行预处理。<br />）的区别,根据你的视觉效果需求选择合适的方法。
