GitHub - kefranabg/readme-md-generator: ? CLI that generates beautiful README.md...

 3 years ago
source link: https://github.com/kefranabg/readme-md-generator
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.


Welcome to readme-md-generator wave

CLI that generates beautiful README.md files.
readme-md-generator will suggest you default answers by reading your package.json and git configuration.

sparkles Demo

readme-md-generator is able to read your environment (package.json, git config...) to suggest you default answers during the README.md creation process:


Generated README.md:

cli output

Example of package.json with good meta data:

// The package.json is not required to run README-MD-GENERATOR
  "name": "readme-md-generator",
  "version": "0.1.3",
  "description": "CLI that generates beautiful README.md files.",
  "author": "Franck Abgrall",
  "license": "MIT",
  "homepage": "https://github.com/kefranabg/readme-md-generator#readme",
  "repository": {
    "type": "git",
    "url": "git+https://github.com/kefranabg/readme-md-generator.git"
  "bugs": {
    "url": "https://github.com/kefranabg/readme-md-generator/issues"
  "engines": {
    "npm": ">=5.5.0",
    "node": ">=9.3.0"

rocket Usage

Make sure you have npx installed (npx is shipped by default since npm 5.2.0)

Just run the following command at the root of your project and answer questions:

npx readme-md-generator

Or use default values for all questions (-y):

npx readme-md-generator -y

Use your own ejs README template (-p):

npx readme-md-generator -p path/to/my/own/template.md

You can find ejs README template examples here.

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].


Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]



Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

handshake Contributing

Contributions, issues and feature requests are welcome.
Feel free to check issues page if you want to contribute.
Check the contributing guide.


bust_in_silhouetteFranck Abgrall

Show your support

Please star this repository if this project helped you!

memo License

Copyright © 2019 Franck Abgrall.
This project is MIT licensed.

This README was generated with heart by readme-md-generator

About Joyk

Aggregate valuable and interesting links.
Joyk means Joy of geeK