Create a README.md for your project from a simple form. Fill in the name and description, add badges, then write or switch on sections — features, installation, usage, screenshots, configuration, contributing and more — reorder them, and pick a license. A table of contents with working GitHub links is generated for you, and a live preview shows the result. Download README.md when it's ready. It's free and runs entirely in your browser.
| Heading | Anchor |
|---|---|
| Getting Started | #getting-started |
| Getting Started! | #getting-started |
| C++ & Rust | #c--rust |
| Getting Started (second time) | #getting-started-1 |
At minimum: what the project is, how to install it, how to use it and its license. Contributing guidelines and screenshots help most projects too.
GitHub creates anchors with specific rules — lowercase, punctuation removed, spaces as hyphens, numbered duplicates. This generator follows them exactly.
Yes, with the up and down arrows. Empty sections are left out automatically.
MIT is the most permissive common choice; Apache-2.0 adds a patent grant; GPL and AGPL require derivatives to stay open source.
No. The README is generated in your browser.
The README is assembled from ordered sections — features, installation, usage, screenshots, configuration, API, tests, contributing, FAQ, acknowledgements and license — that can be renamed, reordered, switched off or left empty, in which case they're omitted rather than leaving a bare heading. The license section is written for you from the chosen SPDX license, or as an all-rights-reserved notice for proprietary code. The table of contents is generated with GitHub's own heading-anchor rules: text is lowercased, punctuation other than hyphens and underscores is dropped, each space becomes a hyphen, and repeated headings get -1, -2 suffixes — the details that make hand-written TOC links silently fail to jump on GitHub. The project's H1 is counted first, exactly as GitHub counts it. A live preview renders the Markdown with the same parser used elsewhere on the site and sanitizes the HTML before display. The result can be copied or downloaded as README.md.