Build a complete, well-formatted README with badges — see it rendered as you go.
Runs in your browserNo sign-up required
Live Preview
My Project
A short, one-line description of what this project does.
Features
Fast and lightweight
Works out of the box
Well documented
Installation
npm install my-project
Contributing
Contributions are welcome! Please open an issue first to discuss what you'd like to change.
Fork the repository
Create your feature branch (git checkout -b feature/my-feature)
Commit your changes
Push to the branch and open a Pull Request
License
This project is licensed under the MIT License — see the LICENSE file for details.
How to Use This Tool
1Fill in the basicsTitle, tagline, and badges — license, build status, or a version badge.
2Describe the projectA short description and a features list, one line each.
3Add installation and usageA command to install it and a code example showing how to use it, each in a proper fenced code block.
4Copy or downloadThe preview updates live and renders exactly like GitHub will — grab the Markdown or save it directly as README.md.
Frequently Asked Questions
Are the badges real, working badges?
Yes — the license, build-status, and version badges use shields.io's static badge URLs, the same service most GitHub READMEs use. They'll render correctly the moment you paste the generated Markdown anywhere that supports it.
Can I edit the README further after generating it?
Yes — this produces a complete starting file, not a locked template. Download it and keep editing in any text editor, or keep adjusting the form here since the preview updates live.
Does this analyze my actual codebase to write the README?
No — this is a guided template builder, not an AI that reads your repository. You fill in the details yourself, which keeps it fast, free, and accurate to what you actually want documented, rather than guessed.
Is my project information uploaded anywhere?
No — everything you type is assembled and rendered entirely in your browser. Nothing is sent to a server.