如何在reStructuredText中实现可保留前导空格的HTML<pre>等价块？

之前你试过的两种写法无法满足需求的核心原因：

• | 开头的行块（Line Block）设计目标是支持诗歌、地址这类带相对缩进的排版场景，会自动剥离所有行的公共前导缩进，无法精确保留指定的行首空格；
• :: 触发的隐式字面块无法保留空格，本质是缩进规则不匹配导致块识别失败，并非功能本身不支持。

正确使用隐式字面块 #

reStructuredText 原生的字面块本身和HTML <pre>的渲染逻辑完全一致，会1:1保留块内所有的行首空格、连续间隔、换行内容，没有自动格式规整的问题。只要严格遵循以下缩进规则，就能直接生效：

• 触发标记::独立占一行，和后续内容块之间空一行
• 内容块的整体缩进层级，必须比::所在行的缩进深至少2个空格
• 块内任意位置的前导空格、字符间隔都会被原样保留

正确写法示例：

普通正文段落，后续接需要保留格式的内容：
::

    |  text
    |      text
    |    text

如果块识别成功，渲染出来的内容会完全和你预期的带不同前导空格的排版一致。

使用显式代码块指令规避缩进坑 #

如果靠隐式::容易搞错缩进阈值，直接用显式的code-block指令是最不容易出错的方案，块内的所有空白字符都会被完整保留：

.. code-block:: text

    |  text
    |      text
    |    text

注意事项：

• 指令后的语言标识（示例里的text代表纯文本，不启用语法高亮）和实际内容块之间必须空一行
• 只要内容块的整体缩进比指令行深，块内的前导空格就不会被自动裁剪
• 如果使用的Sphinx或其他渲染框架开启了代码块自动修剪前导空格的扩展，可以在指令中追加:trim: false选项，强制保留所有空白字符

内容的提问来源于stack exchange，提问作者ZzFlooo