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

时间:2018-02-12 12:43:23

标签: bitbucket markdown wiki

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

<br> - 无效

<br/> - 无效

子弹 - 不起作用

1 个答案:

答案 0 :(得分:1)

如果<br><br />不起作用,那么您可能无法做到。

不幸的是,Bitbucket关于table支持的文档相当稀疏,仅包含以下示例:

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

但是,该语法看起来像PHP Markdown Extra首先引入的相当常见的表语法,后来由GitHubMultiMarkdown和其他人推广。

PHP Markdown Extra规则声明:

  

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

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

GitHub的规范明确指出:

  

无法在表格中插入块级元素。

MultiMarkdown的规则规定:

  

单元格内容必须只在一行

实际上,请注意语法没有提供任何方法来定义何时一行结束而另一行开始(与标题行不同,标题行包括将其与表格主体分开的行)。由于无法定义行之间的划分,因此唯一可行的方法是每行是否为自己的行。因此,行不能包含多行文本。

因此,表格单元格中的任何文本都必须是内嵌文本,可以在一行中表示(因此两个空格的Markdown标准后面跟一个换行符不起作用;子弹也不会像它们那样是块级列表元素)。当然,原始HTML <br>标记是内联文本,并且有资格作为在表格单元格中插入换行符的方法。但是,某些Markdown实现不允许所有原始HTML作为安全措施。如果您正在使用这样的实现(Bitbucket似乎正在使用),则根本无法在表格单元格中包含换行符。

我意识到有些人发现上述令人沮丧和限制。但是,有趣的是在MultiMarkdown关于表格的文档中注意以下建议:

  

MultiMarkdown表支持旨在为大多数人员处理大多数表;它不包含所有人的所有表。如果您需要复杂的表格,则需要手动创建它们或使用专为输出格式设计的工具。但是,在某些时候,如果您发现MultiMarkdown表太受限制,您应该考虑表是否真的是最好的方法。

有趣的建议是考虑使用表格之外的其他内容,如果你能用相当有限的表格语法做你想做的事情。但是,如果表格确实是正确的工具,那么您可能需要手动创建它。提醒一下,original rules州:

  

Markdown不是HTML的替代品,甚至不接近它。它的   语法非常小,仅对应一个非常小的子集   HTML标签。想法是来创建一个更容易的语法   插入HTML标记。在我看来,HTML标签已经很容易了   插入。 Markdown的想法是让它易于阅读,书写和   编辑散文。 HTML是发布格式; Markdown是写作   格式。因此,Markdown的格式化语法仅解决了这些问题   可以用明文传达。

     

对于任何Markdown语法未涵盖的标记,您只需   使用HTML本身。没有必要在其前面加上或划定它   表示您正在从Markdown切换到HTML;你只需要使用   标签

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