DevToys Web Pro iconDevToys Web ProBlog
Rate us:
Try browser extension:

Badge Generator (Shields-style SVG)

Presets
Style
Logo (SVG or PNG data URI)

Preview

build: passing

SVG code

  • Markdown (shields.io)

  • Markdown (self-hosted SVG)

  • Download the SVG above, commit it to your repository (for example as badge.svg) and reference it with this relative path to avoid depending on shields.io.

    HTML

  • reStructuredText

  • AsciiDoc

  • shields.io static URL

  • Technical details

    How the Badge Generator Works

    What the Badge Generator Does

    The Badge Generator builds shields-style status badges as standalone SVG files. Enter a label and a message, pick colors (shields names such as brightgreen, hex or rgb values) and one of five styles: flat, flat-square, plastic, for-the-badge or social. Text widths are approximated from Verdana metrics so the badge fits its content, and everything is rendered in your browser. You get the SVG code, a download, the equivalent shields.io URL and ready-to-paste snippets.

    Common Use Cases

    README badges summarize build status, coverage, version, license, supported platforms and sponsorship. Use this tool when you want a custom badge that shields.io does not offer, a badge that must work offline or in a private network, or a static SVG committed to your repository so documentation never breaks when a third-party service is down. Presets for build passing, MIT license, version, coverage and PRs welcome give you a quick start.

    Output Formats

    The output includes raw SVG, Markdown with a shields.io image URL, Markdown pointing at a self-hosted badge.svg, an HTML img tag, reStructuredText image directive and AsciiDoc image macro. The shields.io static URL follows the documented escaping rules: a dash becomes two dashes, an underscore becomes two underscores and spaces become underscores. The URL is only generated as text and is never requested.

    Common Pitfalls and Edge Cases

    Colors that are not a recognized name, hex value or rgb() triple are ignored and the default is used, which prevents injecting markup into the SVG. Logos must be base64 SVG or PNG data URIs and are embedded as images, never as raw markup. Badge width is an approximation, so very unusual fonts or non-Latin text may render slightly wider than the box. GitHub serves SVGs from your repository with a restrictive content policy, so use the raw URL or the shields.io variant when embedding outside the repository.