Setting a Markdown processor for your GitHub Pages site using Jekyll
You can choose a Markdown processor to determine how Markdown is rendered on your GitHub 页面 site.
GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。
People with write permissions for a repository can set the Markdown processor for a GitHub 页面 site.
GitHub 页面 supports two Markdown processors: kramdown and GitHub's own extended CommonMark processer, which is used to render GitHub Flavored Markdown throughout GitHub Enterprise. 更多信息请参阅“关于 GitHub 上的书写和格式化”。
You can use GitHub Flavored Markdown with either processor, but only our CommonMark processor will always match the results you see on GitHub Enterprise.
-
On GitHub Enterprise, navigate to your site's repository.
-
In your repository, browse to the _config.yml file.
-
In the upper right corner of the file view, click to open the file editor.
-
Find the line that starts with
markdown:
and change the value tokramdown
orGFM
. -
在页面底部,键入简短、有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。更多信息请参阅“创建多个合作作者的提交."
-
在 commit message(提交消息)字段下方,决定要将提交添加到当前分支还是添加到新分支。如果当前分支为
master
,则应选择为提交创建新分支,然后创建拉取请求。 -
单击 Propose new file(提议新文件)。