我可以在标记中合并表行吗

有没有办法在标记文件(如 ReadMe.md 文件)中的表列中创建合并行?

就像这样:

table

174871 次浏览

不,这是不可能的 GitHub-Flavored Markdown。正如 规格解释(强调添加) :

表中其余行的单元格数可能有所不同。如果标题行中的单元格数少于单元格数,则为 插入空单元格。如果有更大的,过剩被忽略:

当然,您总是可以回到原始的 HTML。事实上,GitHub 在它们的 白名单上包含了 rowspan(和 colspan)属性。

<table>
<thead>
<tr>
<th>Layer 1</th>
<th>Layer 2</th>
<th>Layer 3</th>
</tr>
</thead>
<tbody>
<tr>
<td rowspan=4>L1 Name</td>
<td rowspan=2>L2 Name A</td>
<td>L3 Name A</td>
</tr>
<tr>
<td>L3 Name B</td>
</tr>
<tr>
<td rowspan=2>L2 Name B</td>
<td>L3 Name C</td>
</tr>
<tr>
<td>L3 Name D</td>
</tr>
</tbody>
</table>

你自己在 https://jsfiddle.net/7h89y55r/试试

标准通用标记不支持表,也不引用或推荐任何特定的表扩展(2018-03年度最新修订永久连结)。您的问题并没有特别提到 Github 风格的 Markdown (GFM) ,但是 GFM 是基于带有表扩展的通用标记的,而表扩展不支持这一点。

至少 v5的 MultiMarkdown 支持这些类型的表(Permalink 医生) ,就像 Michael Fortin for PHP Markdown Ultra 所做的那样,转向:

|             |          Grouping           ||
First Header  | Second Header | Third Header |
------------ | :-----------: | -----------: |
Content       |          *Long Cell*        ||
Content       |   **Cell**    |         Cell |


New section   |     More      |         Data |
And more      | With an escaped '\|'         ||
[Prototype table]

进入 Table

我通常使用 降价(VSCode 内置的 markdown & my Ghost blog use it) ,它只支持 Github 风格的表,但有人用它为这些表创建了一个扩展(减价多元表)。最终,你还是有选择的。

Vscode 插件 降价延长通过集成 减价多元表支持其他答案描述的扩展表格式

我在关于另一种解决方案的评论中回答了 OP 的问题,但是评论被压缩成了一行。在这里添加它作为正确显示格式的答案。

您可以使用 AsciiDoc 而不是 Markdown。GitHub 现在支持它。只需使用 README.adoc而不是 README.md您的表在 AsciiDoc 语法中:

[cols="^.^,^.^,^.^"]
|===
|Layer1 |Layer2 |Layer3


.4+|L1 Name .2+|L2 Name A |L3 Name A
|L3 Name B
.2+|L2 Name B |L3 Name C
|L3 Name D
|===

如果您正在使用 Jekyll,以支持表单元 校准融合等等,我认为下面我写的可以帮助您更容易地做到这一点。

Jekyll-space-< em > 提供强大支持的 Jekyll 插件 Table,mathjax,背景音乐,背景音乐,美人鱼,视频,youtube,表情,视频,每日动作等等

Https://github.com/jeffreytse/jekyll-spaceship

目前,这些扩展功能已经提供:

  • 跨多列的单元格
  • 跨多行的单元格
  • 单元格文本分别对齐
  • 不需要表头
  • 对表头行或数据行进行分组

价格:

table code

上面的代码将被解析为:

html table

这是不可能在标准的降价,但是,有一些解决方案,支持这一特点。前面提到的 Multimarkdown 之一,但是我想推荐另一个支持它的在线 Markdown 编辑器: Μr2编辑器

它支持行和列的合并,并从输出中生成一个漂亮的 PDF。例如:

|               |          Grouping             ||         Grouping 2         ||  Not Grouped    |
| First Header  | Second Header | Third Header   | Forth Header | Fifth Header | Sixth Header    |
| ------------- | :-----------: | -------------: | :----------: | :----------: | --------------- |
| Tall Cell     |          *Long Cell*          ||         *Long Long Cell*                    |||
| ^^            |   **Bold**    | 1. first item  | *Italic*     | 3. third item | + first point  |\
| ^^            |               | 1. second item |              | 1. forth item | + second point |


| New section   |     More      |         Data   | ... - -- --- |||
| And more      | With an escaped \|          || "Try 'quotes' in quotes "         |||
[Compicated table]

将被呈现为:

enter image description here

我使用 Postman 来编写 API 文档,发现可以混合使用 line readme。通过在 | | 分隔符中插入 HTML 来使用 HTML 的 md 表示法,从而实现更健壮的设计。我假设对于其他使用标记的平台也是一样的,比如 GitHub,尝试一下,看看它是否适合你。

下面的示例将表嵌套在表单元格中:

       | Field  | Description |  Optional | Default |
| ------ | ----------- | --------- | ------- |
| manual_entry_indicator | no: is not is allow manual entry <br /> yes: is manual entry enabled| yes | no |
| amounts | json object containing all transaction amounts <br /> <br /> <table> <tr> <td> Subfield </td> <td> Description </td> <td> Optional </td> <td> Default </td> </tr> <tr> <td> tip </td>  <td> transaction tip amount </td> <td> yes </td> <td> NA </td> </tr> <tr> <td> total </td> <td> equal to Base  Amount + Base amount for  Reduced State Tax + City Tax + State Tax + Reduced State Tax + Tip or Cash back </td> <td> no </td> <td> NA </td> </tr> <tr> <td> cashback </td> <td> cash back amount </td> <td> yes </td> <td> NA </td> </tr> <tr> <td> state_tax </td> <td> State tax amount </td> <td> yes </td> <td> NA </td> </tr> <tr> <td> city_tax </td> <td> City tax amount </td> <td> yes </td> <td> NA </td> </tr> <tr> <td> reduced_tax </td> <td> Reduced state tax amount </td> <td> yes </td> <td> NA </td> </tr> <tr> <td> base_reduced_tax </td> <td> Reduced state tax base amount </td> <td> yes </td> <td> NA </td> </tr> </table> | no | NA |

will be rendered like this