feat(docs): add format flag to which selects docs output formats

cmds/docs.js

@@ -11,6 +11,13 @@ module.exports = {
       alias: 'p',
       describe: 'Publish to GitHub Pages',
       default: false
+    },
+    docsFormats: {
+      alias: 'd',
+      describe: 'Which documentation formats to build',
+      type: 'array',
+      choices: ['html', 'md'],
+      default: ['html']
     }
   },
   handler (argv) {

cmds/release.js

@@ -14,6 +14,13 @@ module.exports = {
       choices: ['node', 'browser', 'webworker'],
       default: ['node', 'browser', 'webworker']
     },
+    docsFormats: {
+      alias: 'd',
+      describe: 'Which documentation formats to build',
+      type: 'array',
+      choices: ['html', 'md'],
+      default: ['html']
+    },
     build: {
       describe: 'Run build tasks before release',
       default: true

src/docs/build.js

@@ -50,6 +50,12 @@ function writeDocs (output) {
     }))
 }
 
+function writeMdDocs (output) {
+  const docsPath = utils.getPathToDocs()
+  return fs.ensureDir(docsPath)
+    .then(() => fs.writeFileSync(utils.getPathToDocsMdFile(), output))
+}
+
 function build (ctx) {
   return Promise.all([
     utils.getPkg(),
@@ -60,13 +66,22 @@ function build (ctx) {
     const pkg = res[0]
     const files = res[1]
 
-    return documentation.build(files, getOpts(pkg))
-      .then((docs) => documentation.formats.html(docs, {
-        theme: require.resolve('clean-documentation-theme'),
-        version: pkg.version,
-        name: pkg.name
-      }))
-      .then(writeDocs)
+    return Promise.all(ctx.docsFormats.map((fmt) => {
+      if (fmt === 'md') {
+        return documentation.build(files, getOpts(pkg))
+          .then((docs) => documentation.formats.md(docs))
+          .then(writeMdDocs)
+      }
+      if (fmt === 'html') {
+        return documentation.build(files, getOpts(pkg))
+          .then((docs) => documentation.formats.html(docs, {
+            theme: require.resolve('clean-documentation-theme'),
+            version: pkg.version,
+            name: pkg.name
+          }))
+          .then(writeDocs)
+      }
+    }))
   })
 }
 

src/utils.js

@@ -167,6 +167,15 @@ exports.getPathToDocsFile = () => {
   return path.join(exports.getPathToDocs(), 'index.html')
 }
 
+/**
+ * Path to documentation index.md.
+ *
+ * @returns {string}
+ */
+exports.getPathToDocsMdFile = () => {
+  return path.join(exports.getPathToDocs(), 'index.md')
+}
+
 exports.hook = (env, key) => (ctx) => {
   if (ctx && ctx.hooks) {
     if (ctx.hooks[env] && ctx.hooks[env][key]) {