如何在reStructuredText文档中控制图片后的间距？

针对你遇到的图片后段落紧贴、用|生成间距过大的问题，2023年后有更规范的非取巧方案，分场景推荐：

1. Sphinx环境下用CSS精确控制（推荐） #

这是最合规、易维护的方案，通过样式表统一管控所有图片的间距：

• 在Sphinx项目的_static目录下创建/修改custom.css，添加样式：

  /* 给所有图片设置底部间距，数值可按需调整 */
  img {
      margin-bottom: 1.2em;
  }
  /* 若使用带标题的figure，同步调整容器间距 */
  figure {
      margin-bottom: 1.2em;
  }
  

• 在项目的conf.py中配置加载自定义CSS：

  html_css_files = ['custom.css']
  

  生成HTML后，所有图片会自动添加合适的底部间距，无需手动插入空元素。

2. 纯reST文档（非Sphinx）的轻量方案 #

若不依赖Sphinx，可通过raw指令插入HTML样式精准控制间距：

.. image:: ..\\images\\myfig.png
   :width: 420
   :align: center

.. raw:: html
   <br style="margin-bottom: 0.8em;"/>

New paragraph continues here

这种方式比单纯用|更灵活，可通过调整margin-bottom数值控制间距大小，需确保渲染器支持HTML raw指令。

3. 进阶：自定义reST指令 #

如果需要频繁使用带固定间距的图片，可在Sphinx中扩展自定义指令，比如编写一个image_with_space指令，默认添加指定间距。此方案需要基础Python开发能力，适合有定制化需求的场景。

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