---

GitHub 項目的README.md為自述文件，可對該項目進行介紹，解釋等。

使用 Github Pages 和 Hexo 搭建的博客，如果在最開始建立倉庫的時候沒有創建README.md文件，那么在后期如何添加呢？

添加方法：在根目錄 source 文件夾下新建README.md即可，該文件使用 Markdown 語法。

然而當我們執行 hexo g -d 部署博客的時候會發現README.md變成了 README.html，如下所示：

原因就在于當我們在執行 hexo g -d 命令時，.md 文件會被轉化成 HTML 文件，并將這些文件放到 public 目錄里，最后再提交到遠程 GitHub 倉庫，而 Hexo 也提供了一個方法，讓md文件不被轉換成HTML，在根目錄的 _config.yml 配置文件里，找到 skip_render 關鍵字，添加 README.md，讓解釋器跳過渲染就行了：

skip_render: README.md

官方文檔：https://hexo.io/docs/configuration
拓展閱讀：《Hexo + Github Pages 自定義一個不使用主題模板渲染的獨立頁面》
我的博客：https://www.itrhx.com/

總結

以上是生活随笔為你收集整理的Hexo 博客添加 README.md 以及部署到 GitHub 丢失/显示不正常解决方法的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。