Installation

$ npm i dmd-readme --save
# or
$ yarn add dmd-readme

Usage

Description:

Pass the plug-in name to jsdoc2md or dmd:

jsdoc2md --plugin dmd-readme

This plugin is initially a fork from dmd-readable, which:

• removes global indexes
• places descriptions in block-quotes
• adds more whitespace before headings
• changes the delimiter for multiple types in param tables to a comma
• adds alias output

config(path) ⇒ *

| Param | Type | Description | | --- | --- | --- | | path | string | The config path |

Description:

Grabs configuration options

features()

Description:

Loads AVA test files located config.features

pkg(key) ⇒ *

See: docs.hbs for an example of how to use this function

| Param | Type | Description | | --- | --- | --- | | key | string | The package property you want returned |

Description:

Reads info from the package.json file.

prefixLines(string, replacer) ⇒ string

| Param | Type | Description | | --- | --- | --- | | string | string | The string to modify | | replacer | string | The string to prefix to each line |

Description:

Prefixes a string to the beginning of each line in the first string

stripJsdocComment(jsDocCommentBlock, replaceValue) ⇒ String

| Param | Type | Description | | --- | --- | --- | | jsDocCommentBlock | String | | | replaceValue | String | Value with to replace comment blocks |

Returns: String - The comment without the asterisks
Description:

Removes all asterisks and additional white spaces from JSDoc comments

Example

const jsDocSyntax = `/**
 * A JSDoc description
 *
 * Hello
 **\/`

 // => Outputs:
 // A JSDoc description
 //
 // Hello

jsCodeToMd(jsCode) ⇒ string

| Param | Type | | --- | --- | | jsCode | String |

Description:

Converts given jsCode into markdown by stripping jsDoc comments

License

MIT

© 2020-present Martin Rafael Gonzalez [email protected]