协议配置平台 – Markdown 转 html

Markdown 转 HTML 是用在协议配置平台中“使用帮助”、“更新日志”这种静态页面，发布的时候转成 html 页面；关于协议配置平台，参照这里，第一个就是。

方案：利用 gulp-markdown 模块，监听 markdown 文档的变化，自动转为 html。

转换的时候，可以利用 wrapper，对生成的 html 进行包装或引入 js 或 css，进一步对转换后的文档进行格式化。

gulpfile 配置如下：

var gulp = require('gulp');
var wrapper = require('gulp-wrapper');
var markdown = require('gulp-markdown');
 
// markdown2html
gulp.task('mark', function () {
    gulp.src([
        'server/md/**.md'        // 在这儿配文件
    ])
        .pipe(markdown())
        .pipe(wrapper({
            //header: '<div class="md-html"><link rel="stylesheet" href="../../css/md.css"/><script src="../../js/md.js"></script>',
            //footer: '</div>'
        }))
        .pipe(gulp.dest('server/md/mdhtml'));
});
 
// watch markdown2html
gulp.task('md', function () {
    gulp.run('mark');
    gulp.watch('server/md/*.md', ['mark']);
});

运行 gulp mark 执行一次转换；

运行 gulp md 监听文件，发生变动就自动转换；