markdown - DOCFX 使用 Markdown 格式化表格而不更改模板

Question

是否可以在 docfx 下使用 Markdown 更改表格的布局?

例如，由于列之间的间距，下表的可读性不是很好。事件没有交替的行颜色:

| Property | Description |
|---|---|
| URL | `/api/<version>/auth/login` |
| Method | `post` |
| Success | Http status *200* |
| Failure | Http-status *400/500* |
| Content/Media-Type | `application/json` |
| Authorization | *no* |
| Roles | - |

这就是它在 doxfx 中的样子:



某种预期的行为:

Answer 1

我们将扩展默认模板:

创建文件:(Project Folder)\template\styles\main.js
默认的 DocFX 模板使用 Bootstrap 和 JQuery，因此在 main.js 中输入以下内容:

$(document).ready(function ()
{
   $("table").addClass("table table-bordered table-striped table-condensed");
})

这使得 Markdown 表与 Api 文档中的表相同。
要使用 Bootstrap 表格样式，请参阅 http://www.w3schools.com/bootstrap/bootstrap_tables.asp

现在，我们将此模板添加到 docfx.json:
在 docfx.json 中，替换 "template": ["default"]与 "template": ["default", "template"] .