documentation-markdown-api-theme

documentation's theme that output markdown.

Install

Install with npm:

npm install documentation-markdown-api-theme

Usage

Convert example.js to Markdown API reference

$ documentation build --access public --theme documentation-markdown-api-theme -f html -o out.md example.js

Simulate documentation readme command using add-text-to-markdown:

npm i -g add-text-to-markdown
documentation build --access public --theme documentation-markdown-api-theme -f html -o out.md example.js
echo out.md | add-text-to-markdown path/to/file.md --section "section name" --write

Why using `-f html`

See https://github.com/documentationjs/documentation/issues/550

Example Output

`hello_destructuring({ name, age })`

hello with destructuring params

Parameters

name: string
age: number

`hello(text: string): string`

Parameters

text: string

Returns: string - echo text

`commentsToAST(comments: Array<Object>, opts: Object, callback: Function): undefined`

Given a hierarchy-nested set of comments, generate an remark-compatible Abstract Syntax Tree usable for generating Markdown output

Parameters

comments: Array<Object> - nested comment
opts: Object - currently none accepted
callback: Function - called with AST

Returns: undefined

`Person`

Person class

`constructor({ name })`

Parameters

name: string - Person name

`getName(): string`

get person name

Returns: string

Changelog

See Releases page.

Running tests

Install devDependencies and Run npm test:

npm i -d && npm test

Contributing

Pull requests and stars are always welcome.

For bugs and feature requests, please create an issue.

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request :D