我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2020-11-12. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

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

您可以选择一个 Markdown 处理器来确定 Markdown 在 GitHub Pages 站点上的呈现方式。

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

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

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

您可以在任一处理器上使用 GitHub 风格的 Markdown,但只有我们的 CommonMark 处理器始终与您在 GitHub Enterprise Server 上看到的结果相匹配。

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

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

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

    编辑文件按钮

  4. 找到以 markdown: 开头的行,然后将值更改为 kramdownGFM

    config.yml 中的 Markdown 设置

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

    有关更改的提交消息

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

    提交分支选项

  7. 单击 Propose new file(提议新文件)

    提议新文件按钮

延伸阅读