現在大家都喜歡用markdown來寫技術博客，這篇文章將闡述搭建支持markdown的簡易博客方法。

我的寫作需求

通過閱讀本文，您將學會搭建滿足以下條件的博客：

博客只用書寫markdown文件

能支持版本控制

免費，不需要租服務器或主機

編寫、部署博客不依賴復雜的環境

技術選型

markdown是一種簡單文本格式的書寫語法，寫好md文件后，要展示在瀏覽器有三種思路：

通過php、Java、ruby等解析后展示，這種方式需要服務器支持。如gitblog、gollum

解析成靜態文件后放在托管空間上，看起來很完美，但本地必須安裝環境，個人認為還是不方便。如jekyll、hexo

直接將md文件托管到托管空間，由前端直接解析后展示。如mdwiki

比較下來，我還是選擇了最后一種方式，因為它使用起來太簡單了，不用搭建任何環境。雖然搭建的博客比較簡單，但對于個人博客來說夠用了。

mdwiki

mdwiki其實就是用js分析md文件，在前端轉換成dom顯示在瀏覽器。使用方法非常簡單，直接將mdwiki.html文件下載下來，重命名為index.html放在md文件夾根目錄即可，瀏覽器訪問的格式為..../index.html#!xx.md，默認訪問index.md。

配置

mdwiki可以用json配置一些屬性，直接在根目錄配置config.json文件即可，具體的配置可以參靠官網文檔：

{

"useSideMenu": true,

"title":"非專業Java程序員博客",

"lineBreaks": "gfm",

"additionalFooterText": "All content and images ? by xi.yang | ",

"anchorCharacter": "#"

}

博客目錄

mdwiki的目錄本身也是用md文件定義的，直接在根目錄創建navigation.md就行，只能支持2級目錄，具體的語法可以參考博客最后的源碼分享。

主題

mdwiki也支持主題更換，可以去bootswatch下載喜歡的主題css文件，放到根目錄，并在navigation.md配置對應的主題名稱即可：

[gimmick:theme](cerulean)

注意名稱要小寫，如果是默認的bootswatch樣式是不用下載css文件的，直接配置名稱即可，高階玩家可以參考語法自己定義漂亮的樣式。

自動生成目錄

完成以上步驟簡單而漂亮的的博客就搭好了，現在要做的就是寫md格式博客，并更新目錄配置，就可以在博客上看到更新了。但是文章寫多了就會感覺很麻煩，每次都要花時間去維護navigation.md，如果是已經有很多現成的md文檔，初始化會更嫌麻煩！

為了簡化這個過程，筆者寫了個簡單的python腳本，根據文件夾和文檔直接生成目錄配置文件，這樣每次無論改動多少內容，直接執行一下python腳本就可以了，具體代碼可以直接看源碼分享。

碼云pages配置

接下來就是發布了，可以發布到github或者碼云上，推薦使用碼云，畢竟國內速度要快點，隨便在碼云上創建一個項目，將根目錄的所有文件push上去，然后在服務-pages中開啟服務即可訪問，如：我的博客。

無論用碼云還是用github，這時候都是用的他們的二級域名，我們也可以使用自己的域名。首先在根目錄創建CNAME文件，寫入自己的域名，如果是github，可以配置自己的域名，然而碼云是沒有這個功能的，但是可以去域名提供商配置Url轉發(由于筆者在萬維網買的域名說開通這個功能還要單獨收費，沒有測試，理論上是可行的)。

一鍵部署

完成上面的所有配置后，我們寫博客的步驟就簡化為：

在對應文件夾寫md文本博客。

執行python腳本。

git命令add、commit、push。

這里git操作很煩，每次我們都要執行好幾個命令才能完成部署，細想我們的個人博客其實不需要記錄什么提交說明。于是筆者又寫了個shell腳本，將執行python腳本和一系列git命令一起執行。

這樣每次改完博客后直接執行這個腳本就完了，非常方便！windows用戶裝了git直接在git bash界面就可以執行腳本。腳本在源碼中也有，執念于提交說明的也可以修改腳本，傳入提交說明即可。

源碼分享

以上博客集成代碼的源碼地址為：md_blog，將所有的文件都集成好了，大家fork下來就可以直接用，參考項目的readme幾分鐘就能完成博客搭建。

總結

以上是生活随笔為你收集整理的md 生成目录 码云_搭建简易博客方案的全部內容，希望文章能夠幫你解決所遇到的問題。

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