fix(markdown): Start headings in Markdown at h2

docs/NODE_API.md

@@ -1,6 +1,6 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# build
+## build
 
 Generate JavaScript documentation as a list of parsed JSDoc
 comments, given a root file as a path.
@@ -54,7 +54,7 @@ documentation.build(['index.js'], {
 
 Returns **[undefined](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined)** calls callback
 
-# buildSync
+## buildSync
 
 Generate JavaScript documentation given a list of inputs. This internal
 method does not support require-following and it returns its results
@@ -100,7 +100,7 @@ var results = documentation.buildSync(['index.js']);
 
 Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** list of results
 
-# lint
+## lint
 
 Lint files for non-standard or incorrect documentation
 information, returning a potentially-empty string
@@ -145,14 +145,14 @@ documentation.lint('file.js', {}, function (err, lintOutput) {
 
 Returns **[undefined](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined)** calls callback
 
-# formats
+## formats
 
 Documentation's formats are modular methods that take comments
 and options as input and call a callback with writable objects,
 like stringified JSON, markdown strings, or Vinyl objects for HTML
 output.
 
-# formats.html
+## formats.html
 
 Formats documentation as HTML.
 
@@ -179,7 +179,7 @@ documentation.build(['index.js'], {}, function (err, res) {
 
 Returns **[undefined](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined)** Calls callback.
 
-# formats.markdown
+## formats.markdown
 
 Formats documentation as
 [Markdown](http://daringfireball.net/projects/markdown/).
@@ -206,7 +206,7 @@ documentation.build(['index.js'], {}, function (err, res) {
 
 Returns **[undefined](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined)** calls callback
 
-# formats.json
+## formats.json
 
 Formats documentation as a JSON string.
 

lib/output/markdown_ast.js

@@ -204,7 +204,7 @@ function commentsToAST(comments, options, callback) {
 
   return callback(null, rerouteLinks(linkerStack.link,
     u('root', generatorComment.concat(comments.reduce(function (memo, comment) {
-      return memo.concat(generate(1, comment));
+      return memo.concat(generate(2, comment));
     }, [])))));
 }
 

package.json

@@ -85,7 +85,7 @@
   },
   "scripts": {
     "lint": "eslint bin lib index.js test",
-    "doc": "documentation build index.js -f md --access=public > docs/NODE_API.md",
+    "doc": "./bin/documentation.js build index.js -f md --access=public > docs/NODE_API.md",
     "changelog": "standard-changelog -i CHANGELOG.md -w",
     "self-lint": "node ./bin/documentation.js lint",
     "test": "npm run lint && npm run self-lint && tap -t 120 --coverage --nyc-arg=--cache test/*.js test/lib test/streams"

test/fixture/auto_lang_hljs/multilanguage.output.md

@@ -1,6 +1,6 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# multilanguage.input
+## multilanguage.input
 
 **Extends Foo, Bar**
 

test/fixture/boolean-literal-type.output.md

@@ -1,6 +1,6 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# f
+## f
 
 **Parameters**
 

test/fixture/boolean-literal-type.output.md.json

@@ -6,7 +6,7 @@
       "value": "<!-- Generated by documentation.js. Update this documentation by updating the source code. -->"
     },
     {
-      "depth": 1,
+      "depth": 2,
       "type": "heading",
       "children": [
         {

test/fixture/class.config.output.md

@@ -1,14 +1,14 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# MyClass
+## MyClass
 
 This is my class, a demo thing.
 
 **Properties**
 
 -   `howMany` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** how many things it contains
 
-## getFoo
+### getFoo
 
 Get the number 42
 
@@ -18,12 +18,12 @@ Get the number 42
 
 Returns **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** forty-two
 
-## getUndefined
+### getUndefined
 
 Get undefined
 
 Returns **[undefined](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined)** does not return anything.
 
-# Hello
+## Hello
 
 World

test/fixture/class.output.md

@@ -1,14 +1,14 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# MyClass
+## MyClass
 
 This is my class, a demo thing.
 
 **Properties**
 
 -   `howMany` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** how many things it contains
 
-## getFoo
+### getFoo
 
 Get the number 42
 
@@ -18,7 +18,7 @@ Get the number 42
 
 Returns **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** forty-two
 
-## getUndefined
+### getUndefined
 
 Get undefined
 

test/fixture/class.output.md.json

@@ -6,7 +6,7 @@
       "value": "<!-- Generated by documentation.js. Update this documentation by updating the source code. -->"
     },
     {
-      "depth": 1,
+      "depth": 2,
       "type": "heading",
       "children": [
         {
@@ -139,7 +139,7 @@
       ]
     },
     {
-      "depth": 2,
+      "depth": 3,
       "type": "heading",
       "children": [
         {
@@ -336,7 +336,7 @@
       ]
     },
     {
-      "depth": 2,
+      "depth": 3,
       "type": "heading",
       "children": [
         {

test/fixture/document-exported-export-default-object.output.md

@@ -1,5 +1,5 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# document-exported-export-default-object.input
+## document-exported-export-default-object.input
 
-# x
+## x

test/fixture/document-exported-export-default-object.output.md.json

@@ -6,7 +6,7 @@
       "value": "<!-- Generated by documentation.js. Update this documentation by updating the source code. -->"
     },
     {
-      "depth": 1,
+      "depth": 2,
       "type": "heading",
       "children": [
         {
@@ -16,7 +16,7 @@
       ]
     },
     {
-      "depth": 1,
+      "depth": 2,
       "type": "heading",
       "children": [
         {

test/fixture/document-exported-export-default-value.output.md

@@ -1,3 +1,3 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# document-exported-export-default-value.input
+## document-exported-export-default-value.input

test/fixture/document-exported-export-default-value.output.md.json

@@ -6,7 +6,7 @@
       "value": "<!-- Generated by documentation.js. Update this documentation by updating the source code. -->"
     },
     {
-      "depth": 1,
+      "depth": 2,
       "type": "heading",
       "children": [
         {

test/fixture/document-exported.output.md

@@ -1,44 +1,44 @@
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
-# z
+## z
 
-## zMethod
+### zMethod
 
-# x
+## x
 
 **Parameters**
 
 -   `yparam`  
 
-# Class
+## Class
 
-## classMethod
+### classMethod
 
-## classGetter
+### classGetter
 
-## classSetter
+### classSetter
 
 **Parameters**
 
 -   `v`  
 
-## staticMethod
+### staticMethod
 
-## staticGetter
+### staticGetter
 
-## staticSetter
+### staticSetter
 
 **Parameters**
 
 -   `v`  
 
-# T5
+## T5
 
 Type: [boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)
 
-# y2Default
+## y2Default
 
-# y4
+## y4
 
 Description of y3
 
@@ -48,56 +48,56 @@ Description of y3
 
 Returns **void** 
 
-# object
+## object
 
-## prop
+### prop
 
-## func
+### func
 
-# method
+## method
 
-# getter
+## getter
 
-# setter
+## setter
 
 **Parameters**
 
 -   `v`  
 
-# f1
+## f1
 
-# f3
+## f3
 
-# T
+## T
 
 Type: [number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)
 
-# T2
+## T2
 
 Type: [string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)
 
-# T4
+## T4
 
 Type: [string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)
 
-# f4
+## f4
 
 **Parameters**
 
 -   `x` **X** 
 
-# o1
+## o1
 
-# om1
+## om1
 
-# f5
+## f5
 
 f5 comment
 
 **Parameters**
 
 -   `y` **Y** 
 
-# o2
+## o2
 
-# om2
+## om2