Skip to content

README Generator

Fill in the fields and get a complete README.md in Markdown.

Quick Tool Overview

The README Generator turns a handful of fields into a complete README.md in the order people actually read one — what it is, whether it solves their problem, how to install it, what using it looks like — with empty sections left out entirely.

What it does
Generates a README.md from fields you fill in
You give it
A name, description, install command and usage
You get back
Conventionally ordered Markdown
Best for
A new project, or a repository with no README
Developer Tools Free, unlimited use No sign-up Runs in your browser

About the README Generator

The README is the first thing anyone sees and usually the last thing anyone writes. This turns a handful of fields into a complete, conventionally ordered README.md, so the part you have to think about is the content rather than the scaffolding.

The order is not arbitrary. A visitor wants to know what this is in one line, whether it solves their problem, how to install it, and what using it looks like — in that order, and most of them leave before the fourth. So the tagline and description come first, features and installation next, and contributing, testing and licence at the bottom where people go looking for them. Empty sections are left out entirely rather than emitted as a heading with nothing under it.

Key features of the README Generator

Ordered for a reader

Tagline, description, features, install, usage — most visitors leave before the fourth section, so the important ones come first.

Nothing empty is emitted

A field you skip produces no heading at all, rather than a section title with nothing underneath it.

Working badges

Licence, build status and npm version, generated from your repository path so they resolve rather than sitting as placeholders.

Table of contents when it earns its place

Generated with real anchors, and only offered once there are enough sections for it to be useful.

Fenced code blocks

Install and usage examples are fenced with the right language, so they highlight on GitHub instead of rendering as grey text.

How to use the README Generator

  1. 1

    Name the project

    Add the title and a one-line description of what it does.

  2. 2

    Fill in what you have

    Features, install command, usage example, licence — anything left blank is skipped.

  3. 3

    Choose badges

    Build status, licence and npm version badges are generated from your repository path.

  4. 4

    Copy the Markdown

    Save it as README.md in the root of your repository.

Frequently asked questions

What the project is and who it is for, in language someone outside your team would understand. "A caching layer for Postgres queries in Node" tells a reader more than "A blazing fast, modern solution for your data needs" ever will.

Reviews of the README Generator

What people who use the README Generator think of it. Reviews come from visitors and are posted as written.

No ratings yet

Yours would be the first.

  • 5 0 reviews rated 5 stars
  • 4 0 reviews rated 4 stars
  • 3 0 reviews rated 3 stars
  • 2 0 reviews rated 2 stars
  • 1 0 reviews rated 1 star

Write a review

Used this tool? Your rating helps the next person decide.

Your rating

Plain text only — links, email addresses and HTML are not accepted. Your name and review are shown publicly; nothing else is collected. See the privacy policy.

0 reviews

Newest first

No reviews yet

Be the first to rate the README Generator. It takes half a minute and no account.

Write the first review

More developer tools