如何移除GitHub仓库中.md文件网页自动生成的仓库索引页头部？

我之前也遇到过一模一样的问题！GitHub Pages自动添加的这个带仓库索引链接的头部，大多是因为默认的Jekyll主题或者自动站点生成模板在搞鬼，试试下面几个靠谱的解决办法：

• 检查并修改_config.yml配置
  如果你的仓库用了Jekyll主题，很多默认主题会自动开启顶部导航。找到仓库根目录的_config.yml文件（没有的话就新建一个），看看有没有header_pages、nav这类配置项，把指向仓库索引页的链接删掉，或者直接设置header_pages: []来完全禁用头部导航。要是想彻底摆脱主题自带的头部，也可以在配置里写theme: null，或者换用极简主题比如theme: jekyll-minimal（这个主题默认没有多余头部）。

• 自定义页面布局
  你的.md文件可能默认继承了主题的布局模板，导致头部被自动插入。可以在目标.md文件的开头加上YAML front matter，指定自定义布局：

  ---
  layout: custom
  ---
  

  然后在仓库里新建_layouts文件夹，创建custom.html文件，写一个不带任何额外头部的基础布局：

  <!DOCTYPE html>
  <html>
  <head>
    <meta charset="UTF-8">
    <title>{{ page.title }}</title>
  </head>
  <body>
    {{ content }}
  </body>
  </html>
  

  这样你的.md内容就会直接渲染在这个干净的布局里，不会有多余的头部了。

• 排查自动站点生成设置
  如果你是通过GitHub仓库设置里的「GitHub Pages」选择了「自动生成站点」功能，那这个头部很可能是生成过程中默认添加的。可以重新走一遍生成流程，在配置步骤里留意有没有「Include navigation bar」这类选项，取消勾选它就行；或者干脆放弃自动生成，手动管理页面内容和布局。

• 临时方案：用CSS隐藏头部
  要是上面的方法都暂时没法生效，也可以用CSS快速隐藏头部元素。在你的.md文件最开头加上这段代码：

  <style>
    /* 这里的类名要根据实际头部的HTML类调整，比如常见的.site-header或者.header */
    .site-header {
      display: none !important;
    }
  </style>
  

  不过这只是临时解决，还是建议从配置或布局入手彻底解决问题。

内容的提问来源于stack exchange，提问作者ericz