今天终于做了一直以来我特别想要实现的功能,就是在自己的服务器上支持markdown文档的渲染,昨天经过我的不懈努力终于实现了md文档的渲染,以后就可以写markdown的静态文档了,好了先来看一下效果吧;

http://www.521php.com/md/

先说一下实现的原理,当然此文章主要讲了我的实现,当然还有其他的实现方式,原理都是差不多的。

首先,我们需要安装kramdown解释器,这个很好理解吧,和php一样,他的特点标签能够实现渲染肯定需要解释器来解析,这里kramdown解释器的官网为http://kramdown.gettalong.org/installation.html,这是安装界面,根据自己的系统安装即可,不过他需要安装ruby依赖。然后我通过nginx的url转发,将.md的文档转发给一个php文件来处理,这个php文件,就调用kramdown解释器来解析对应文档即可。

原理很简单吧,看下具体实现步骤吧,

1、安装kramdown解释器

安装完,(ruby可以直接yum安装),可以写一个md的测试文件,使用kramdown命令试一下。

2、制作kramdown解析程序

这里我用的是php,当然也可以用其他语言,只要可以调用linux的system命令即可,当然php安装有的时候会屏蔽这些敏感函数,注意要释放一下。

文件发一下

实现了一些简单的文件遍历和样式,这个可以随意制作,我是用的github的样式

3、nginx配置url重写

当然这里就根据自己的喜好了,当然也可以制作soket服务,不过php毕竟做服务的话不太好,还有配合shell监控,所以不如直接使用url重写了

4、另外

最后在nginx的web服务加上个默认页

这样就可以默认访问index.md文件了

这样就实现了自己网站的markdown文件解析了,以后可以写md文档了!