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

Question

如何在Bitbucket Wiki的Markdown中的表单元格内添加换行符？
<br>-不起作用
<br/>-不起作用

项目符号-不起作用

Answer 1

如果<br>或<br />不起作用，那么您可能无法使用。

不幸的是，Bitbucket关于table支持的文档很少，仅包含以下示例:

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

但是，该语法看起来像是 PHP Markdown Extra最初引入并随后由 GitHub， MultiMarkdown等流行的相当普通的表语法。

PHP Markdown Extra的规则规定:

You can apply span-level formatting to the content of each cell using regular Markdown syntax:

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

GitHub的规范明确指出:

Block-level elements cannot be inserted in a table.

而且MultiMarkdown的规则规定:

Cell content must be on one line only

实际上，请注意，该语法没有提供任何方法来定义一行的结束时间和另一行的开始时间(与 header 行不同，该行包括将其从表的主体中分开的一行)。由于您无法定义行之间的分隔，因此它唯一可行的方法是每一行都是自己的行。因此，一行不能包含多行文本。

因此，表单元格中的任何文本都必须仅是内联文本，并且只能在一行中表示(因此，两个空格的Markdown标准后跟换行符将不起作用；项目符号也不会起作用，因为它们将成为块级列表元素)。当然，原始HTML <br>标记是内联文本，可以作为在表格单元格中插入换行符的一种方式。但是，某些Markdown实现禁止所有原始HTML作为安全措施。如果您正在使用这样的实现(Bitbucket似乎正在使用该实现)，则根本不可能在表格单元格中包含换行符。

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

MultiMarkdown table support is designed to handle most tables for most people; it doesn’t cover all tables for all people. If you need complex tables you will need to create them by hand or with a tool specifically designed for your output format. At some point, however, you should consider whether a table is really the best approach if you find MultiMarkdown tables too limiting.

有趣的建议是，如果使用有限的表语法无法做您想做的事情，请考虑使用表以外的东西。但是，如果表格确实是正确的工具，那么您可能需要手动创建它。提醒一下， original rules状态:

Markdown is not a replacement for HTML, or even close to it. Its syntax is very small, corresponding only to a very small subset of HTML tags. The idea is not to create a syntax that makes it easier to insert HTML tags. In my opinion, HTML tags are already easy to insert. The idea for Markdown is to make it easy to read, write, and edit prose. HTML is a publishing format; Markdown is a writing format. Thus, Markdown's formatting syntax only addresses issues that can be conveyed in plain text.

For any markup that is not covered by Markdown's syntax, you simply use HTML itself. There's no need to preface it or delimit it to indicate that you're switching from Markdown to HTML; you just use the tags.

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