Generate your project's README from package.json data! Uses Lo-Dash/Underscore-style templates. Need something more powerful and pluggable? Try verb instead!
Install with npm
$ npm i -g readme-generatorFrom the command line, run:
$ readme
$ readme -t # readme template to usepackage.json and the parsed argv object are used as context for templates.
Example
Given the template Name: <%= foo %>, the following:
$ readme --foo barWould render Name: bar
ERB/Lo-dash style templates may be used.
Examples
<%= name %>
<%= description %>
<%= license %>
<%= Object.keys(dependencies).join(', ') %>
Anything that works for Lo-Dash/Underscore templates should work here.
If you add a .readme.md to the root of your project it will automatically be used. Or you can specify a custom template to use with the -t command.
If .readme.md and -t are not defined, the template.md in the root of this project will be used.
Sometimes it's necessary to escape templates, like when you're documentation includes examples of templates. You can escape templates by adding an extra % in the opening delimiter.
Example
<%%= foo %>
Will render to:
<%= foo %>
Install dev dependencies:
$ npm i -d && npm testPull requests and stars are always welcome. For bugs and feature requests, please create an issue
Jon Schlinkert
Copyright © 2018 Jon Schlinkert Licensed under the MIT license.
This file was generated by readme-generator on March 31, 2018.