Markdox is a structured documentation generator based on Dox, Markdown and EJS with support for JavaScript, CoffeeScript and Iced CoffeeScript. This plugin is a gulp wrapper for it.

First, install gulp-markdox as a development dependency:

npm install --save-dev gulp-markdox

Then, add it to your gulpfile.js:

var markdox = require("gulp-markdox");
gulp.task("doc", function(){
  gulp.src("./src/*.js")
    .pipe(markdox())
    .pipe(gulp.dest("./doc"));
});

It can take on .coffee and .iced files, too.

If you want to concatenate all your generated documentation files, use concat option. All parsed docfiles will be passed to template at once:

var markdox = require("gulp-markdox");
gulp.task("doc", function(){
  gulp.src("./src/*.js")
    .pipe(markdox({ concat: "doc.md" })
    .pipe(gulp.dest("./doc"));
});

Following example does the same in more fine-grained manner:

var markdox = require("gulp-markdox");
gulp.task("doc", function(){
  gulp.src("./src/*.js")
    .pipe(markdox.parse())
    .pipe(markdox.format())
    .pipe(markdox.render({ concat: "doc.md" }))
    .pipe(gulp.dest("./doc"));
});

Please refer to markdox's documentation for further documentation of these options.x'.

Generates markdox documentation from source code in the input.

Type: Function

Custom compiler (user in parse phase).

Type: String Default: utf-8

Encoding of templates and files to parse (used in parse phase).

Type: Function

Custom formatter (used in format phase).

Type: String

File name for concatenated docfile.

Type: String

Path or the custom template (used in render phase).

Input: commented source code in file contents.

Output: raw document object generated from comments assigned to javadoc property.

Input: raw document object generated from comments assigned to javadoc property.

Output: formatted document object assigned to formattedDoc property.

Input: formatted document object assigned to formattedDoc property.

Output: rendered documentation in file contents.

Copyright © 2016 Maciej Chałapuk. Released under MIT License.