reStructuredText 中的多行表格单元格？答案

【问题标题】：Multi-line table cell in reStructuredText?reStructuredText 中的多行表格单元格？
【发布时间】：2012-11-10 08:57:22
【问题描述】：

有没有办法在表格单元格中输入换行符？例如，假设我有一个这样的表：

+==========+==========+==========+
+ Header 1 + Header 2 + Header 3 +
+==========+==========+==========+
+ Item 1   +          +          +
+ Item 2   +          +          +
+----------+----------+----------+

我希望上面创建一个包含两行三列和第二行第一列的表格，以在不同的行上显示第 1 项和第 2 项。

我尝试了行块语法 |，但它在表格单元格中不起作用。我可以使用列表语法，但我不希望出现项目符号。

【问题讨论】：

标签： restructuredtext

【解决方案1】：

首先我认为你的表格语法不正确，应该不是：

+----------+----------+----------+
| Header 1 | Header 2 | Header 3 |
+==========+==========+==========+
| Item 1   |          |          |
| Item 2   |          |          |
+----------+----------+----------+

请注意，第一行由连字符而不是等号组成，并且行由管道分隔，|，而不是加号。

现在有了这张表，line block syntax:

+----------+----------+----------+
| Header 1 | Header 2 | Header 3 |
+==========+==========+==========+
| | Item 1 |          |          |
| | Item 2 |          |          |
+----------+----------+----------+

似乎有效：使用Pandoc 进行测试，左下角的单元格将转换为以下 HTML：

<td align="left">Item 1<br />Item 2</td>

注意Item 1 和Item 2 之间的换行符<br />。

【讨论】：

糟糕，我在输入表格时太草率了。我刚刚编辑了它。您的解决方案确实是正确的。行块语法之前对我不起作用，因为我弄错了（我在 | 和 Item 之间没有空格）。
对于尝试使用 Sphinx 的任何人：如果使用 LaTeX 构建器，请注意使用 tabularcolumns 指令的表不能包含行块或其他块级语法。
确认它适用于 Sphinx 2.4.4 和 rst2pdf 0.96。我在自定义 CSS 文件中添加了 .rst-content .line-block > margin: 0。

【解决方案2】：

你也可以像这样在行之间留一个间隙

+----------+----------+----------+
| Header 1 | Header 2 | Header 3 |
+==========+==========+==========+
| Item 1   |          |          |
|          |          |          |
| Item 2   |          |          |
+----------+----------+----------+

这种方法往往对编辑更友好，所以他们不会认为你不小心添加了一个额外的管道

【讨论】：