使用Docsify搭建文檔類型網站

docsify 可以快速幫你生成文檔網站。不同于 GitBook、Hexo 的地方是，它不會生成靜態的 .html 文件，所有轉換工作都是在運行時。如果你想要開始使用它，只需要創建一個 index.html 就可以開始編寫文檔并直接部署在 GitHub Pages。

Docsify官方文檔：https://docsify.js.org/#/zh-cn/

安裝 docsify-cli 工具

推薦全局安裝 docsify-cli 工具，可以方便地創建及在本地預覽生成的文檔。

npm i docsify-cli -g

初始化項目

# 初始化目錄 docsify init docs # 啟動一個本地服務器，可以方便地實時預覽效果。默認訪問地址 http://localhost:3000 docsify serve docs

初始化成功后，可以看到 ./docs 目錄下創建的幾個文件

• index.html 入口文件
• README.md 會做為主頁內容渲染
• .nojekyll 用于阻止 GitHub Pages 忽略掉下劃線開頭的文件
• 直接編輯 docs/README.md 就能更新文檔內容，當然也可以添加更多頁面。

部署到服務器

若在linux部署，不需要安裝docsify，只需將服務器的訪問根目錄設定為 index.html 文件即可。

修改nginx配置后，reload一下：

./nginx -s reload

---

效果演示

win10 本地 Typora 目錄結構

筆記記在 Typora 中，注意設置一下圖片存儲路徑，這樣就可以在粘貼圖片的之后自動生成相對路徑，便于部署

設置方式：

相對路徑效果：

整個目錄結構：

服務器上運行效果

在本地修改之后，直接 push 到 github，可以在linux服務器上寫一個自動拉取腳本，即可同步更新頁面，非常方便。

---

附：Linux 安裝 npm 方法（部署不需要安裝npm）

###### 安裝npm（實際上，部署不需要安裝npm...） ###### # 淘寶鏡像，下載node，解壓 wget https://npm.taobao.org/mirrors/node/latest-v14.x/node-v14.15.3-linux-x64.tar.gz tar -zxvf node-v14.15.3-linux-x64.tar.gz # 添加軟鏈接 ln -s /usr/local/node/node-v14.15.3-linux-x64/bin/npm /usr/local/bin/npm ln -s /usr/local/node/node-v14.15.3-linux-x64/bin/node /usr/local/bin/node # 安裝成功，查看版本 npm -v

總結

以上是生活随笔為你收集整理的本地 MarkDown 怎么部署到服务器上？教你使用 Docsify 搭建个人博客的全部內容，希望文章能夠幫你解決所遇到的問題。

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