<img src="https://img.shields.io/badge/build-passing-brightgreen" alt="build: passing">
https://img.shields.io/badge/build-passing-brightgreen
Markdown tools
README Badge Generator
Build shields.io badges with a live preview and copy them as Markdown, HTML, or a plain image URL.
How it works
Step 1
Choose a badge type
Start from a custom badge or a preset, or pick a live GitHub or npm badge.
Step 2
Customize it
Set the text, color, style, and an optional logo and link.
Step 3
Copy the code
Copy the Markdown or HTML snippet and paste it at the top of your README.
Frequently asked questions
Where are the badge images hosted?
Badges are served by shields.io, a free public badge service. This page only builds the URLs; nothing is stored on our side.
Do GitHub and npm badges update automatically?
Yes. Dynamic badges are rendered by shields.io from live data each time they are viewed.
How do I add a logo?
Enter a Simple Icons slug such as github, npm, react, or typescript in the Logo field.
Can I link a badge somewhere?
Yes. Add an https:// link and the snippet wraps the badge image in a link.
Related tools: README generator · Emoji cheat sheet · Markdown editor