DEV Community

Cover image for Generate beautiful README in 10 seconds
Franck Abgrall
Franck Abgrall

Posted on

Generate beautiful README in 10 seconds

Hi 👋

A well structured and beautiful README is very important, especially for opensource projects. This is the first thing that visitors will see when they discover your project.

This is why I created readme-md-generator, a tool that generates beautiful basic README.md files with less efforts !

All you need to do is answer a few questions, and readme-md-generator will do the rest 👌

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

demo

Generated README.md :

cli output

Feel free to check out the github repos if you're interested !

Latest comments (33)

Collapse
 
arturssmirnovs profile image
Arturs Smirnovs

Nice, good job creating generator.. i made one my self for fun: arturssmirnovs.github.io/github-pr...

Collapse
 
gilton profile image
Gilton

Great post!! Thanks a lot!!

Collapse
 
vip3rousmango profile image
Al Romano

This is awesome!!!! :D

Collapse
 
jaredharbison profile image
JaredHarbison

I like it. I love it. Consistency and convention! For a future iteration... maybe a linkedin prompt along with github and twitter?

Collapse
 
kefranabg profile image
Franck Abgrall
Collapse
 
douglasamarelo profile image
Douglas "Amarelo" Lopes

Hey, cool!

It is usually difficult and annoying to create a readme file. There is no standard way of doing this, everyone has to create their own and it is not always simple and easy to understand.
With this tool, we have a well-planned and structured way of doing this.

Well done. This is a very good tool.

Thanks for sharing.

Collapse
 
maheshkale profile image
Mahesh K

Thank you. I tested it. Really handy tool. :)

Collapse
 
steffenpedersen profile image
Steffen Pedersen

This is pretty cool ✌🏻 It's great if you don't know how to start writing a README file.

Collapse
 
sroy8091 profile image
Sumit Roy

How they generated their README.md file?

Collapse
 
vagoel profile image
Varun

Franck ,this is so Good.I always find difficulties remembering markdown syntax and creating readme files.
Using this project , I will never be lazy again in creating consistent ,useful and beautiful readme files.

Thanks a lot.

Collapse
 
k_penguin_sato profile image
K-Sato

Neat

Collapse
 
thluiz profile image
Thiago Luiz Silva

Wow!!! Great!

Collapse
 
jcoelho profile image
José Coelho

Wow! Great idea! This is what I need at work, most of my colleagues have never written a Readme file. 😒

Collapse
 
peterj profile image
Peter Jausovec

this looks great! now I have to go back to every github repo I have, and re-generate readmes :)

Collapse
 
tonythetiger323 profile image
Tony Greeley

This is amazing! Great work! Thank you!

Some comments may only be visible to logged-in visitors. Sign in to view all comments.