What README badges are for
Badges are small "label | message" pills at the top of a README. They summarise a project — licence, build status, version, how to contribute — in a format every developer recognises.
Design a "label | message" badge for a README or a website, see it on light and dark backgrounds, and copy the snippet to paste.
A click opens this generator with your badge filled in — so others can make one like it. Pick "My link" to send readers elsewhere.

Badges are small "label | message" pills at the top of a README. They summarise a project — licence, build status, version, how to contribute — in a format every developer recognises.
Markdown is what READMEs on GitHub, GitLab and most package registries read. Use HTML on a website, or in a README when you need to set the size or align badges on one line.
Start from a ready-made badge or type a label and a message.
Pick the colours and the style; the preview shows it on a light and a dark page, like GitHub's two themes.
Copy the Markdown for a README or the HTML for a website, or download the SVG.
A few badges at the top of a README answer the first questions at a glance: licence, status, whether contributions are welcome.
Keep them short and few — three to five — and link each one to where the answer lives (the licence file, the docs).
Pro tipNo account and no tracking: the badge image is generated from its address every time it is displayed.
Prefer to depend on nothing? Download the SVG and host it with your project.
PrivacyEverything about badges