md 生成目录 码云_搭建简易博客方案

现在大家都喜欢用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": tr