将 Markdown 处理器更新为 kramdown
如果您尚未使用 kramdown(Jekyll 3.0.0 的默认 Markdown 处理器),则必须在 _config.yml 文件中更新 Markdown 处理器。
GitHub 页面 仅支持 kramdown 作为 Markdown 处理器。
默认情况下,kramdown 支持 GitHub 风格的 Markdown,因此您可以将 Markdown 与 GitHub 页面 配合使用,如同在 GitHub 上使用 Markdown 一样。
提示:如果您当前正在使用支持 GitHub 风格 Markdown 的 Markdown处理器(例如 Rdiscount 或 Redcarpet),则无需更改 Markdown 文件即可正确呈现内容。
如果您使用除 Kramdown 以外的 Markdown 处理器,则必须更改站点配置文件中的 Markdown 设置。
-
在 GitHub Enterprise 上,导航到仓库的主页面。
-
在仓库中,浏览到 _config.yml。
-
在文件视图的右上角,单击 打开文件编辑器。
-
找到以
markdown:
开头的行,然后将值更改为kramdown
。 -
在页面底部,键入简短、有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。更多信息请参阅“创建多个合作作者的提交."
-
在 commit message(提交消息)字段下方,决定要将提交添加到当前分支还是添加到新分支。如果当前分支为
master
,则应选择为提交创建新分支,然后创建拉取请求。 -
单击 Propose file change(提议文件更改)。
有关使用 kramdown 的更多信息,请参阅 kramdown 的快速参考指南或 kramdown 的正式文档。