Sphinx中使用list-table指令能否创建真正的多行单元格？

实现方法 #

Sphinx 的 list-table 指令原生支持单个单元格内插入多行内容，无需使用空行占位的折中方案，直接使用行内竖线换行语法即可实现真正的多行单元格，完全适配你第二列需要放长引用的需求。

具体写法示例如下：

.. list-table:: Title
   :header-rows: 1

   * - Heading row 1, column 1
     - Heading row 1, column 2
     - Heading row 1, column 3
   * - | Row 1, column 1 第一行
       | Row 1, column 1 第二行
       | Row 1, column 1 第三行
     - 可以直接放置超长的科学文献引用内容，不需要适配固定列宽
     - Row 1, column 3
   * - | Row 2, column 1 第一行
       | Row 2, column 1 第二行
     - 第二列长引用内容
     - Row 2, column 3 

只需要保证同个单元格内的多行内容统一以 | 开头、缩进层级和当前单元格的起始位置对齐即可，单元格内也可以正常嵌套列表、代码块等其他 RST 元素。

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