有沒有辦法用GitHub頁面創建一個簡單的Markdown wiki？

Question

我想使用GitHub頁面在Markdown中編寫和託管我自己的系統管理wiki。

我已經創建了一個myname.github.io庫，並與文字放在它只有一個index.html文件：

Hello world! 

其結果是我想要一個結構化的降價維基，例如：

index.html 
io/mdadm.md 
io/lvm.md 
io/disks.md 
mail/postfix.md 
mail/mail.md 
bacula/setup.md 
bacula/tips.md 
bash/tips.md 
system/applications/repositories.md 

當我將導航到http://myname.github.io我想看到與其他鏈接的主頁面。我將手動在HTML中創建主頁面。

當我將導航到http://myname.github.io/system/applications/repositories或其他我想看到呈現Markdown HTML。

如何創建此佈局並強制GitHub將Markdown文件呈現爲HTML？

有更好的方式使用GitHub作爲一個免費的維基？

我也明白我可以在存儲庫和默認的GitHub存儲庫接口中使用標準的md文件。但與Markdown提供的純HTML相比，這個接口過於複雜。

Answer 1

你可以使用Jekyll這個靜態站點生成器，它非常適合GitHub頁面，並且使用Markdown開箱即用。

參見documentation here。