Github页面没有显示,取而代之的是字符串

时间:2019-06-20 19:22:02

标签: markdown github-pages

对于我的github页面网站,我尝试使用markdown表,但是它们不起作用:

| hello | hi |
| --- | --- |
| hi | hello |

我得到这样的字符串:

| hello | hi | | --- | --- | | hi | hello |

您可以在this页上看到它

1 个答案:

答案 0 :(得分:0)

您的表格必须用空白行包围:

Usage: <code>$PatoBot->removeAdmin($id);</code>

| Argument | Description |
| --- | --- |
| $id | The user id to be removed from the admin list |

Returns true if the user was in the admin array and was removed, false if not.

请注意,我删除了<br>标签,并在表格前后添加了空白行。

之所以需要GitHub Pages,而不是GitHub本身,是因为使用了不同的Markdown处理器。尽管这两种实现非常相似,但还是有一些区别,这只是其中之一。

Jekyll(GitHub Pages使用的静态站点生成器)确实包含support for Commonmark,但是,根据readme in the repo,GitHub Markdown变体目前仅在测试中。该文档似乎还建议默认情况下未启用扩展名(包括表),因此,如果使用它,则还需要显式启用所需的扩展名。根据GitHub提供的most recent information,GitHub Pages使用Jekyll的默认值Kramdown,默认情况下支持表格,但是比起带有表扩展名的Commonmark,它更严格地要求表格用空行包围。为此,我不确定Commonmark在Pages中是否可用。 Jekyll在3.1版和Pages currently supports 3.3版中增加了支持,但自2016年2月宣布仅支持Kramdown(至少我在任何地方都找不到)以来,GitHub都没有声明他们在GitHub页面上支持Commonmark。

鉴于上述情况,用于GitHub Pages的Markdown需要符合Kramdown's rules