Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

Hover over a link to another article to get more details. If you have ideas for how we can improve this page, let us know in the discussion.

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

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

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。 有关详细信息,请参阅“GitHub 的产品”。

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

GitHub Pages 支持两种 Markdown 处理器:kramdown 和 GitHub 自己的 Markdown 处理器,后者用于在整个 GitHub Enterprise Cloud 中呈现 GitHub 风格的 Markdown (GFM)。 有关详细信息,请参阅“关于在 GitHub 上编写和设置格式”。

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

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

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

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

    编辑文件按钮

    注意:除了使用默认文件编辑器编辑和提交文件,还可以选择使用 github.dev 代码编辑器,方法是单击 旁边的下拉菜单并选择“在 github.dev 中打开” 。

    编辑文件按钮下拉菜单

  4. 找到以 markdown: 开头的行,然后将值更改为 kramdownGFM。 整行应显示为 markdown: kramdownmarkdown: GFM

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

  6. 如果在 GitHub.com 上有多个电子邮件地址与你的帐户关联,请单击电子邮件地址下拉菜单,然后选择要用作 Git 作者电子邮件地址的电子邮件地址。 只有经过验证的电子邮件地址才会出现在此下拉菜单中。 如果启用了电子邮件地址隐私,则 <username>@users.noreply.github.com 是默认提交作者的电子邮件地址。 有关详细信息,请参阅“设置提交电子邮件地址”。 选择提交电子邮件地址 1. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 有关详细信息,请参阅“创建拉取请求”。 提交分支选项 1. 单击“提供新文件”。 “提供新文件”按钮

延伸阅读