是否可在reStructuredText表格中使用substitution预定义替换内容？

结论 #

该功能完全可以实现，reStructuredText原生支持在表格单元格内调用预先定义的替换（substitution）填充内容，图片、代码片段类的替换都可正常生效。

写法修正与示例 #

你给出的示例逻辑正确，仅需注意表格分隔线长度要和对应列对齐，避免解析器识别表格结构出错，以下是可直接运行的正确写法：

.. |code1| literalinclude:: code1.cpp
   :linenos: # 可选参数，可按需开启代码行号显示
.. |img1| image:: https://example.com/img1
   :width: 200px # 可选参数，可控制表格内图片的显示尺寸

======  =====
code    image
======  =====
|code1| |img1|
======  =====

使用注意事项 #

• 替换定义必须放在引用它的表格之前，否则解析器无法识别|xxx|格式的替换标记
• 如果替换内容是带换行的块级元素，更推荐使用list-table等复杂表格语法实现，兼容性更好
• 主流的Docutils、Sphinx解析器都完全支持该用法，无需安装额外扩展

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