js-doc-md

Generate readme.md files for Javascript using jsdoc-to-markdown.

Installation

npm i -g @rianbotha/js-doc-md

Usage

Run the following command in the terminal to replace or create a readme.md in the same directory.

js-doc-md path/to/index.js path

The first argument is the path to the file containing your Javascript or a glob. It can be a comma separated list.

Note: Globs needs to be wrapped in quotes.

The second argument is the base path from which the import path will be calculated.

If the file is named index.js the readme.md will be name readme.md. Otherwise the readme will be name filename.md to match your file.

Existing documentation needs to be wrapped between <!-- js-doc-md-start --> and <!-- js-doc-md-end --> for the replacement to work. Only content between these comments will be replaced. This allows you to manually extend readmes without worrying about it being overwritten in future.

Options

• --ignore A filename or glob to exclude. You can comma separate a list. Make sure to wrap globs in quotes.
• --to-console will write the props table to the terminal instead of the file.
• --force Overwrite the current readme if it exists and start and end comments are missing.
• --help or -h display usage options
• --version or -v display version information