我也遇到了这个问题(404)，根本原因是我的文件名为INDEX.md。我在Windows上开发，我的本地Jekyll网站工作正常(因为Windows默认不区分文件名大小写)。当推送到Github时，它不起作用。有一次我重命名了INDEX。Md到索引。Md，一切都很顺利。

我在使用typedocs时遇到了这个问题。README。md工作，但没有实际的文档由我的文档字符串显示，我只是得到了一个404 Github页面屏幕。

要解决这个问题，只需在你的/docs目录(或任何你生成文档的地方)中放置一个空文件，并将其命名为.nojekyll

为了确认，你的文件结构现在应该看起来像:

./docs/.nojekyll  # plus all your generated docs

把这个推到你的远程Github回购和你的链接等现在应该工作。

同时确保你在你的Github设置中选择了:

Settings -> Github Pages -> Source -> master brach /docs folder

根据你的文档框架，你可能必须在每次更新你的文档时重新创建这个文件，这是一个使用typedocs和每次在包中创建.nojekyll文件的例子。json文件:

# package.json

      "scripts": {
        "typedoc": "typedoc --out docs src && touch docs/.nojekyll"
      },

我的页数也保持在404页。联系了技术支持，他们指出url是区分大小写的;解决了我的问题。

在我的例子中，我有名称以_开头的文件夹(如_css和_js)， GH Pages根据Jekyll处理规则忽略这些文件夹。如果不使用Jekyll，解决方法是在根目录中放置一个名为.nojekyll的文件。否则，您可以从这些文件夹中删除下划线

在我的情况下，这是我最近为GitHub页面设置了一个自定义域，但GitHub已经忘记了我的自定义域下(repo)<name>. GitHub。io / Settings / Pages。

我再次添加了自定义域，然后它立即开始工作。

在我的例子中，我的存储库是私有的。将存储库设为公共并再次执行所有步骤。