How to use with gulp

1. Install jsdoc2md in your project

$ npm i jsdoc-to-markdown --save-dev

2. Add a simple task to your gulpfile.js

gulp.task('docs', function () {
  const fs = require('fs')
  const jsdoc2md = require('jsdoc-to-markdown')

  return jsdoc2md.render({ files: 'lib/*.js' })
    .then(output => fs.writeFileSync('docs/api.md', output))
})

3. Or, the synchronous equivalent (node v0.12.0 and over):

gulp.task('docs', function () {
  const fs = require('fs')
  const jsdoc2md = require('jsdoc-to-markdown')

  const output = jsdoc2md.renderSync({ files: 'lib/*.js' })
  fs.writeFileSync('docs/api.md', output)
})