Markdown - 尝试 ¶

• 作者：KK

• 发表日期：2016.03.30

下面尝试将一些写好的markdown文档生成html版本和pdf版本，然后你就可以自己发布出去给其他人学习了

以Web开发调试方案分享为例子，点击下载需要的测试文件，里面带有使用说明，看着用就可以

我这里也提一次，里面有三个目录

• Markdown：这个目录是存放markdown格式文件的地方，你可以随时用文本编辑器修改这些内容做测试。

• generator：这个目录是markdown格式转换成目标格式的转换器程序目录，主要由PHP的Yii2框架编写，并集成了其它第三方类。

• output：这个目录是转换后的输出目录，关于PDF的生成在里面也有说明，但其实搞这么麻烦的话我不如专门下载一个其它生成器来生成PDF，对吧，这里的PDF支持其实用在自动发布文档的项目构建流程上会比较合适。

运行里面的"生成文档.bat"根据提示输入序号回车，就可以进行文档的生成，生成完毕后就进入output找文件即可。

• 经验分享：进一步优化生成脚本将生成出来的html自动传输到公司 ¶

  一台文档服务器的Web主机上，即可让团队成员访问主机就可以看到文档内容了，构造一个微型的在线Wiki

  也通过这个小demo让大家了解我这个技术博客主要是怎样构造出来的，但我个人在其中做了很多定制开发，跟这个demo还是有一些不同的，每人有自己的不同需求吧

在PHP-Yii2里使用 ¶

Yii作为一个普及多年的老框架，已经拥有很多第三方类库，其中就有Markdown类库，我们可以使用它在项目中必要的地方编译Markdown

过程很简单，假设我们有一个E:\文档.md这样的Markdown内容格式文件，则在Yii2的代码里这样调用就可以：

$mdContent = file_get_contents('D:\文档.md');
$css = '<link rel="stylesheet" href="//cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css">';
$mdHtml = \yii\helpers\Markdown::process($mdContent);
$mdHtml = $css . PHP_EOL . $mdHtml; //html里的class都是跟bootstrap对应的，所以要有样式文件
file_put_contents('D:\文档.html', $mdHtml);
echo $mdHtml;