README Badge Generator
Create shields.io-style badges with custom label, message, colour, style and logo for GitHub READMEs.
———Make your project look professional
The small badges at the top of GitHub README files show version, licence, build status, test coverage, downloads or the technologies used at a glance, making your project look maintained and trustworthy.
Customisation
- Label and message text
- Colours (named colours or HEX)
- Style: flat, flat-square, plastic, for-the-badge, social
- A logo from the Simple Icons library
- An optional link
Ready code
Get copy-ready Markdown, HTML and a direct image URL. Special characters are encoded the way shields.io expects, and the preview image is only requested when you click.
How to use README Badge Generator
- Enter the label and message.
- Choose the colour, style and logo.
- Show the badge preview.
- Add the Markdown or HTML code to your README.
Why use this tool?
Create correctly encoded badges in seconds without memorising shields.io URL syntax.
FAQ
Where is the badge image hosted?
Badges are rendered by img.shields.io when someone views your README; this tool only builds the correct address.
Can I create dynamic badges (e.g. npm version)?
This tool is for static badges. Use shields.io's ready endpoints for dynamic ones.
Can I use special characters?
Yes, they're encoded correctly in the URL.
Related tools
Markdown Previewer (Live Editor)
Write Markdown on the left and see the formatted result live on the right; ideal for READMEs.
Open toolMarkdown Table Generator
Build Markdown tables in a spreadsheet-like editor with column alignment, then copy the result.
Open toolMarkdown to HTML Converter
Convert Markdown into clean HTML with GitHub-style tables, task lists and a safe live preview.
Open toolColor Palette Generator
Generate harmonious 5–8 colour palettes: random, complementary, analogous, monochromatic or triadic.
Open tool