GitHub Pages

GitHub Pages (opens new window) 是一项将 Markdown 文件转换为网站并在互联网上免费托管的服务。如果您知道如何使用 GitHub，并且需要创建一个简单的网页，那么 GitHub Pages 是最佳选择。只需在 GitHub 上创建一个新的仓库，提交 Markdown 文件，然后启用 GitHub Pages 功能即可。

GitHub Pages 使用 Jekyll 静态站点生成器来创建网站，其 Markdown 支持非常出色。您可以从 GitHub 提供的预制主题中选择一个作为您的网站主题，也可以使用 Jekyll 主题 (opens new window)，或者使用自定义 CSS。下图展示了一个使用 GitHub 预制主题的示例网页。

令人困惑的是，GitHub Pages 渲染 Markdown 的方式与 GitHub 不同。GitHub 使用自己的 Markdown 处理器；GitHub Pages 使用 jekyll-commonmark (opens new window)。这意味着您的 README.md 文件在 GitHub 网站上和 GitHub Pages 网站上的显示效果会有所不同。例如，表情符号可以在 GitHub 网站上渲染，但不能在使用 GitHub Pages 生成的网站上渲染。

GitHub Pages Markdown 支持

GitHub Pages 支持以下 Markdown 元素。

功能	支持	备注
标题	是
段落	是
换行	是
粗体	是
斜体	是
引用块	是
有序列表	是
无序列表	是
代码	是
水平线	是
链接	是
图片	是
表格	是
围栏代码块	是
语法高亮	是	确保 _config.yml 文件的 kramdown 部分中包含 syntax_highlighter: rouge
脚注	是
标题 ID	是
定义列表	是
删除线	是	可以使用双波浪号（~~文字~~）或单波浪号（~文字~）——两者都可以
任务列表	是
表情符号（复制粘贴）	未知
表情符号（短代码）	未知
高亮	否
下标	否
上标	否
自动 URL 链接	是
禁用自动 URL 链接	是
HTML	是

额外语法支持

作为额外功能，GitHub Pages 还支持以下特殊元素。

元素	Markdown	渲染输出
缩写	*[HTML]: 超文本标记语言 HTML 规范由 W3C 维护。	HTML 规范由 W3C 维护。

另见

• Jekyll 文档 (opens new window)
• kramdown 文档 (opens new window)