在服务器上的readme.md访问的时候 浏览器总会自动下载 那么应该有一个像coding和github一样的可以将readme.md转换成html的插件或者程序

使用的是https://github.com/michelf/php-markdown.git
项目中的转换文件为 compile.php
先看下这个php

$srcDir = $root.DIRECTORY_SEPARATOR.'src'; //待编译目录
$disDir = $root.DIRECTORY_SEPARATOR.'_book'; //编译后文件存放目录
$htmlDir = $root.DIRECTORY_SEPARATOR.'html'; //html公共头文件目录

注释已经很清楚了 由于md文件不一定在src文件夹中,所以我把这个路径改了下,改成要呈现的md所在的文件路径

$srcDir = '我的readme.md路径'; //待编译目录

访问一下这个compile.php就可以完成转换 转换之后的文件在$htmlDir 访问这个路径就可以看到文档了

延伸

由于readme.md会随着接口的产生而增加或者被修改,所以在每次代码往github上推的时候,会戳一下webhook,服务器更新仓库,这个时候,可以加一个webhook,戳一下compile.php,就可以看到更新后的文档

例如

1525530253(1).jpg