@rianbotha/js-doc-md
Version:
A markdown readme generator for Javascript.
37 lines (25 loc) • 1.78 kB
Markdown
# js-doc-md
[](https://www.npmjs.com/package/%40rianbotha%2Fjs-doc-md)
[](https://snyk.io/test/github/rianbotha/js-doc-md?targetFile=package.json)
Generate readme.md files for Javascript using [jsdoc-to-markdown][].
[jsdoc-to-markdown]: https://github.com/jsdoc2md/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