如何在 Bitbucket Wiki 的 Markdown 中的表格单元格内添加换行符？

Question

如何在 Bitbucket Wiki 的 Markdown 中的表格单元格内添加换行符？

<br> -- 不起作用

<br/> -- 不起作用

子弹 - 不起作用

Answer 1

如果<br>或<br />不起作用，那么你可能就做不到。

\n\n

不幸的是，Bitbucket 有关表支持的文档相当稀疏，仅包含以下示例：

\n\n

\n

| Day     | Meal    | Price |\n| --------|---------|-------|\n| Monday  | pasta   | $6    |\n| Tuesday | chicken | $8    |\n

\n

\n\n

然而，该语法看起来像相当常见的表格语法，该语法首先由PHP Markdown Extra引入，后来由GitHub、MultiMarkdown等人推广。

\n\n

PHP Markdown Extra 的规则规定：

\n\n

\n

您可以使用常规 Markdown 语法将跨度级别格式应用于每个单元格的内容：

\n\n

| Function name | Description                    |\n| ------------- | ------------------------------ |\n| `help()`      | Display the help window.       |\n| `destroy()`   | **Destroy your computer!**     |\n

\n

\n\n

GitHub 的规范明确指出：

\n\n

\n

块级元素无法插入表中。

\n

\n\n

MultiMarkdown 的规则规定：

\n\n

\n

单元格内容只能在一行上

\n

\n\n

事实上，请注意，该语法没有提供任何方法来定义一行何时结束而另一行何时开始（与标题行不同，标题行包含一条将其与表主体分开的行）。由于您无法定义行之间的划分，因此唯一可行的方法是每行都是其自己的行。因此，一行不能包含多行文本。

\n\n

因此，表格单元格内的任何文本都只能是内联文本，可以在单行上表示（因此两个空格后跟换行符的 Markdown 标准不起作用；项目符号也不起作用，因为它们是块级列表元素）。当然，原始 HTML<br>标签是内联文本，并且可以作为在表格单元格中插入换行符的一种方式。然而，作为安全措施，一些 Markdown 实现不允许所有原始 HTML。如果您正在使用这样的实现（Bitbucket 似乎正在使用），那么根本不可能在表格单元格中包含换行符。

\n\n

我意识到有些人觉得上述内容令人沮丧和限制。然而，值得注意的是 MultiMarkdown 文档中有关表格​​的以下建议：

\n\n

\n

MultiMarkdown 表格支持旨在为大多数人处理大多数表格；它并没有\xe2\x80\x99 覆盖所有人的所有桌子。如果您需要复杂的表格，则需要手动或使用专门为您的输出格式设计的工具来创建它们。然而，在某些时候，如果您发现 MultiMarkdown 表格限制太多，您应该考虑表格是否真的是最佳方法。

\n

\n\n

有趣的建议是，如果您无法使用相当有限的表语法执行您想要的操作，请考虑使用表以外的其他内容。但是，如果表格确实是正确的工具，那么您可能需要手动创建它。提醒一下，原来的规则规定：

\n\n

\n

Markdown 并不是 HTML 的替代品，甚至不能接近它。它的语法非常小，仅对应于 HTML 标记的一个非常小的子集。我们的想法并不是创建一种可以更轻松地插入 HTML 标签的语法。在我看来，HTML 标签已经很容易插入。Markdown 的想法是让阅读、写作和编辑散文变得容易。HTML 是一种发布格式；Markdown 是一种书写格式。因此，Markdown 的格式化语法仅解决可以用纯文本表达的问题。

\n\n

对于 Markdown 语法未涵盖的任何标记，您只需使用 HTML 本身即可。无需在其前面加上前缀或对其进行分隔即可表明您正在从 Markdown 切换到 HTML；您只需使用 \n 标签即可。

\n

\n\n

因此，手动创建表格需要对整个表格使用原始 HTML。当然，对于那些不允许所有原始 HTML 的实现，您没有该选项。因此，您又回到考虑非表格解决方案或一种在单元格内没有任何换行符的表格格式的方法。

\n