mdbook-extended-markdown-table

用于从 ASCII 文本生成带合并单元格的表格的 mdBook 预处理器。

示例语法

以下表格将具有合并单元格和样式标题，正如预期的那样

    ```extended-markdown-table
    |          |                                      Tool                                   |
    |          |------------------|----------------------|-----------------------------------|
    |          |                  | Markdown Tables      | Extended Markdown Tables          |
    | Feature  |------------------|----------------------|-----------------------------------|
    | Support  |                  |                      | Horizontal      |        ✓        |
    |          | Merged cells     |          ✗           |-----------------|-----------------|
    |          |                  |                      | Vertical        |        ✓        |
    ```

示例输出

查看 去中心化身份协议页面，了解 mdbook-extended-markdown-table 的几个实际应用示例。该页面的源代码位于 此处。

配置

将以下行添加到您的 book.toml

[preprocessor.extended-markdown-table]

就这样！

如何编写自己的表格

请确保使用等宽字体，因为 extended-markdown-table 使用 ASCII 字符的显著对齐来工作。

源代码中的任何管道字符（|）都将被视为网格列分隔符。因此，在输出文本中需要对齐的管道字符非常重要。

网格垂直分隔的最小单位是单行。其他每一行都被视为分隔行；在分隔行上，extended-markdown-table 将在由短划线（-）组成的列分隔符之间查找空格。您可以使单元格高于单行，但请记住，它们将内部表示为多个合并的行，并且它们需要奇数行。建议尽可能使用单行来表示每一行，仅在行的另一单元格需要分割的情况下才使用多行。

表格的第一行和最后一行不应是分隔行；它们应该包含单元格内容。

更多信息

许多 Unicode 字符在表格单元格中工作得很好。只需记住，某些文本编辑器将显示一些 Unicode 字符比正常字符更宽，并且一些 Unicode 字符实际上是多个合并的字符！因此，每一行的实际字符数必须相同，因此根据您使用的字符，它可能在您的文本编辑器中看起来错位。

只要垂直和水平分隔符仍然围绕 HTML 代码对齐，就可以在表格的源代码中嵌入 HTML。

Markdown 不会在表格内解析。