使用 Jekyll 为 GitHub Pages 站点设置 Markdown 处理器

拥有仓库写入权限的人可为 GitHub Pages 站点设置 Markdown 处理器。

GitHub Pages supports two Markdown processors: kramdown and GitHub's own Markdown processor, which is used to render GitHub Flavored Markdown (GFM) throughout GitHub Enterprise Server. 更多信息请参阅“关于 GitHub 上的书写和格式化”。

You can use GitHub Flavored Markdown with either processor, but only our GFM processor will always match the results you see on GitHub Enterprise Server.

1. 在 GitHub Enterprise Server 上，导航到站点的仓库。

2. 在仓库中，浏览到 _config.yml 文件。

3. 在文件视图的右上角，单击 打开文件编辑器。

4. 找到以 markdown: 开头的行，然后将值更改为 kramdown 或 GFM。

5. 在页面底部，输入一条简短、有意义的提交消息，描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 更多信息请参阅“创建有多个合作作者的提交”。

6. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 更多信息请参阅“创建新的拉取请求”。

7. 单击 Propose new file（提议新文件）。

延伸阅读

• kramdown 文档
• GitHub Flavored Markdown 规格