Sphinx是否支持嵌套表格？若支持该如何正确使用？

Sphinx 完全支持嵌套表格，你现有写法的核心问题是内部嵌套表格的行列缩进不符合 reStructuredText 语法规范，且内部表格行列数与设置的宽度参数不匹配。

修正后的可运行写法示例 #

你提供的示例修正后写法如下：

.. list-table:: Title
   :widths: 25 20 30 30
   :header-rows: 1

   * - Field Name
     - Data Type
     - Values
     - Description
   * - boiling_point_f
     - JSON
     - testing
     - .. list-table:: testTitle
          :widths: 25 25 50
          :header-rows: 0

          * - test1
            - test2
            - test3
          * - val1
            - val2
            - val3

核心注意事项 #

• 嵌套表格的所有指令、行内容，缩进必须和外层单元格的内容起始位置严格对齐：外层单元格内的内容，需要相对于外层的-标记再缩进3~4个空格；内部表格的行内容，需要相对于内部的.. list-table::指令再缩进3个空格
• 内部表格设置的:widths:参数对应的列数，必须和每行设置的单元格数量一致，否则会出现渲染异常
• 如果你使用csv-table指令关联CSV文件实现嵌套，遵循同样的缩进规则即可，示例如下：

  * - 外层单元格1
    - 外层单元格2
    - .. csv-table:: 嵌套CSV表格
         :file: ./inner_table.csv
         :widths: 30 30 40
         :header-rows: 1
  

• 若写法正确仍出现渲染异常，可升级你使用的Sphinx主题，部分老旧主题未适配嵌套表格的样式。

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