我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

页面构建失败:Markdown 错误

如果 GitHub 页面代码包含 Markdown 错误,GitHub 页面站点将无法构建。

如果 GitHub 页面 站点因 Markdown 无效而构建失败,将会收到一封如下的电子邮件:

主题:页面构建失败

页面构建因以下错误而失败:

文件 example.md 包含 markdown 错误。

Markdown 错误故障排除

提示:我们强烈建议本地运行 Jekyll,以便在推送到 GitHub 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”

如果未使用 kramdown 作为 Markdown 处理程序,则必须将 Markdown 处理程序更新为 kramdown。 GitHub 页面 只支持 kramdown。

确保电子邮件中提及的文件使用有效的 Markdown 语法。 请参阅“在 GitHub 上编写和设置格式入门”以获取更多帮助,或者参阅 Daring Fireball Markdown 指南以获得更完整的 Markdown 语法指南。

在修复所有 Markdown 错误后,需要提交更改并再次推送到 GitHub 页面 仓库,以在服务器上触发另一次构建。

问问别人

找不到要找的内容?

联系我们