Markdown Badge Generator

shields.io is a free service that renders small status badges as images, like the build, version and license badges you see at the top of many READMEs. This tool builds the static badge URL for you and wraps it in Markdown or HTML.

shields.io uses dashes to separate the label, message and color, so the text has to be escaped. A literal dash becomes --, a literal underscore becomes __, and a space becomes _. This tool applies those rules and URL-encodes the rest, so characters like % or / still work.

Yes. Pick a style such as flat, flat-square or for-the-badge, and add a logo by its simpleicons.org slug (for example github or typescript). They are added to the badge URL as style and logo query parameters.

Add a link and the Markdown output becomes [](your-link), and the HTML wraps the image in an anchor. This is how badges link to your CI dashboard, releases page or license.

Use a named shields.io color like brightgreen, blue, orange or red, a semantic name like success or critical, or any hex code such as ff69b4. Hex codes do not need a leading hash.

No. The badge URL and snippets are built entirely in your browser. Your browser only contacts shields.io when it loads the badge image itself, exactly as it would when the README is viewed.