页面构建失败:Markdown 错误
如果 GitHub 页面代码包含 Markdown 错误,GitHub 页面站点将无法构建。
如果 GitHub 页面 站点因 Markdown 无效而构建失败,将会收到一封如下的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
文件
example.md
包含 markdown 错误。
只有在 Enterprise 实例上启用了出站电子邮件支持时,您才会收到电子邮件。有关详细信息,请联系您的站点管理员。
Markdown 错误故障排除
提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”
如果未使用 kramdown 作为 Markdown 处理程序,则必须将 Markdown 处理程序更新为 kramdown。 GitHub 页面 只支持 kramdown。
确保电子邮件中提及的文件使用有效的 Markdown 语法。 请参阅“在 GitHub 上编写和设置格式入门”以获取更多帮助,或者参阅 Daring Fireball Markdown 指南以获得更完整的 Markdown 语法指南。
在修复所有 Markdown 错误后,需要提交更改并再次推送到 GitHub 页面 仓库,以在服务器上触发另一次构建。