使用 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 的计划”。

从 2024 年 6 月 30 日起，所有 GitHub Pages 版本都将使用 GitHub Actions。 无需进行其他更改，但必须在存储库中启用 GitHub Actions 才能继续构建。 有关 GitHub Actions 运行器的详细信息，请参阅“管理存储库的 GitHub Actions 设置”。

拥有仓库写入权限的人可为 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” 。 还可以单击 GitHub Desktop 克隆存储库并通过 GitHub Desktop 在本地编辑文件。

文件的屏幕截图。 在标头中，一个朝下三角形图标用深橙色框出。

1. 找到以 `markdown:` 开头的行，然后将值更改为 `kramdown` 或 `GFM`。 整行应显示为 `markdown: kramdown` 或 `markdown: GFM`。

  1. 单击“提交更改...”

  2. 在“提交消息”字段中，输入简短、有意义的提交消息，以描述对文件的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息，请参阅“创建有多个作者的提交”。

  3. 如果在 GitHub.com 上有多个电子邮件地址与你的帐户关联，请单击电子邮件地址下拉菜单，然后选择要用作 Git 作者电子邮件地址的电子邮件地址。 只有经过验证的电子邮件地址才会出现在此下拉菜单中。 如果启用了电子邮件地址隐私，则使用无回复电子邮件地址作为默认提交作者的电子邮件地址。 有关无回复电子邮件地址可以采用的确切格式的详细信息，请参阅“设置提交电子邮件地址”。

    GitHub 拉取请求的屏幕截图，其中显示了一个下拉菜单，包含用于选择提交作者电子邮件地址的选项。 已选择 octocat@github.com。

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

    GitHub 拉取请求的屏幕截图，其中显示了一个单选按钮，用于直接提交到主分支或创建新分支。 已选择“新建分支”。

  5. 单击“提交更改”或“建议更改” 。

延伸阅读