Gerador de Ícone de README (estilo Shields.io)
Guia
Gerador de Badges no README
O Gerador de Badges no README cria badges perfeitos em pixels diretamente no seu navegador. Escolha um modelo pré-definido ou crie o seu próprio rótulo e mensagem, escolha cores e um estilo (plano, quadrado plano, para o badge ou plástico), e obtenha saídas prontas para Markdown, HTML, SVG e URL de dados. Sem chamadas a APIs externas, sem dependência de rede, sem badges quebrados quando o serviço está inativo — o SVG é gerado no lado do cliente e incorporado inline.
Como usar
- Escolha um modelo no dropdown de modelos, ou mantenha como Personalizado e preencha seu próprio rótulo e mensagem.
- Escolha uma cor de rótulo e uma cor de mensagem — cores pré-definidas do Shields.io ou um código hexadecimal personalizado.
- Selecione um estilo de badge: plano, quadrado plano, para o badge ou plástico.
- Observe a atualização do pré-visualização em fundos claro e escuro.
- Copie o Markdown, HTML, URL ou SVG bruto — ou baixe o arquivo SVG.
Características
- Quatro estilos de badge – Plano, quadrado plano, para o badge (maiúsculas, mais alto) e plástico com sombreamento de gradiente.
- Modelos incluídos – Versão, licença, status de construção, cobertura, downloads, estrelas e modelo “feito com amor”.
- Pré-visualização em tempo real – Renderização imediata com alternância entre fundo claro e escuro para que você possa ver como o badge se adapta a diferentes temas do README.
- Quatro formatos de saída – Markdown, tag img HTML, URL de dados SVG e marcação SVG bruta.
- SVG autossuficiente – O texto é renderizado como nós SVG reais com larguras medidas, sombras e cantos arredondados onde apropriado.
- Cores personalizadas – Paleta padrão do Shields.io mais um selecionador de hex personalizado.
- 100% do lado do cliente – Sem chamadas a APIs, sem rastreamento, sem limites de taxa. Funciona offline uma vez que a página tenha sido carregada.
- Cópia em um clique e download de SVG – Exporte um arquivo .svg independente para colocar em qualquer repositório.
Casos de uso comuns
- READMEs abertos-fonte – Indique o status de construção, versão, licença, cobertura ou contagem de downloads de forma rápida.
- Dashboards de projetos – Insira badges consistentes em wikis internos e sites de documentação.
- Sites de portfólio – Decore as cartas de projetos com rótulos estilizados sem carregar serviços externos de imagens.
- Páginas de marketing – Use badges “feito com” e personalizados como elementos de destaque leves.
- Documentação offline – Envie badges que se renderizam mesmo atrás de firewalls que bloqueiam o shields.io.
Por que gerar badges localmente?
Serviços remotos de badges são convenientes, mas adicionam um salto de rede toda vez que alguém carrega seu README. Quando esses serviços atrasam, são limitados ou mudam seus padrões, seus badges quebram silenciosamente. Um SVG gerado localmente é um único arquivo estático — ele se renderiza em qualquer lugar onde Markdown ou HTML é suportado, é incluído com seu repositório e sobrevive a falhas de serviço. Também oferece controle total sobre cores, espaçamento e peso da fonte, para que os badges possam seguir um estilo visual consistente em toda organização.
Perguntas frequentes
-
O que é um badge SVG?
Um badge SVG é uma pequena imagem vetorial que exibe um rótulo e uma mensagem em uma forma em forma de pílula. Como é vetorial, ele permanece nítido em qualquer tamanho e pode ser estilizado com cores sólidas, gradientes e texto anti-aliado sem exigir renderização no servidor.
-
Qual a diferença entre o estilo plano e o estilo para o badge?
O plano é o estilo compacto padrão com sombra suave de cima para baixo e cantos arredondados. O estilo para o badge é mais alto, usa letras maiúsculas em negrito e adiciona mais espaço horizontal, tornando-o mais destacado e fácil de ler a distância.
-
Como são calculadas as larguras dos badges SVG?
Cada lado de texto é medido usando um cálculo de métrica de fonte — normalmente a largura de cada caractere na fonte Verdana 11 — depois é adicionado espaço em ambos os lados. A largura do rótulo e da mensagem é somada para produzir a largura total do SVG, para que os retângulos de fundo se alinhem exatamente sob o texto.
-
Por que usar uma URL de dados em vez de uma imagem hospedada?
Uma URL de dados incorpora todo o SVG dentro do próprio Markdown ou HTML, removendo qualquer dependência de hospedagem externa. O badge se renderiza instantaneamente sem necessidade de uma requisição extra, não quebra quando um serviço altera sua API e permanece visível mesmo quando o visualizador está offline.
Instale nossas extensões
Adicione ferramentas de IO ao seu navegador favorito para acesso instantâneo e pesquisa mais rápida
恵 O placar chegou!
Placar é uma forma divertida de acompanhar seus jogos, todos os dados são armazenados em seu navegador. Mais recursos serão lançados em breve!
Ferramentas essenciais
Ver tudo Novas chegadas
Ver tudoAtualizar: Nosso ferramenta mais recente foi adicionado em 24 abr 2026
