Generador de insignias (SVG estilo Shields)
Vista previa
Código SVG
Markdown (shields.io)
Markdown (SVG autoalojado)
Descarga el SVG de arriba, súbelo a tu repositorio (por ejemplo, como badge.svg) y haz referencia a él con esta ruta relativa para no depender de shields.io.
HTML
reStructuredText
AsciiDoc
URL estática de shields.io
Detalles técnicos
Cómo funciona el generador de insignias
Qué hace el generador de insignias
El generador de insignias crea insignias de estado estilo shields como archivos SVG independientes. Escribe una etiqueta y un mensaje, elige colores (nombres de shields como brightgreen, valores hex o rgb) y uno de cinco estilos: flat, flat-square, plastic, for-the-badge o social. El ancho del texto se aproxima con las métricas de Verdana para que la insignia se ajuste a su contenido, y todo se renderiza en tu navegador. Obtienes el código SVG, una descarga, la URL equivalente de shields.io y fragmentos listos para pegar.
Casos de uso habituales
Las insignias de README resumen el estado de la compilación, la cobertura, la versión, la licencia, las plataformas compatibles y el patrocinio. Usa esta herramienta cuando quieras una insignia personalizada que shields.io no ofrece, una insignia que deba funcionar sin conexión o en una red privada, o un SVG estático incluido en tu repositorio para que la documentación nunca se rompa si un servicio de terceros cae. Los preajustes de build passing, licencia MIT, versión, cobertura y PRs welcome te dan un buen punto de partida.
Formatos de salida
La salida incluye SVG sin procesar, Markdown con una URL de imagen de shields.io, Markdown que apunta a un badge.svg autoalojado, una etiqueta img de HTML, una directiva image de reStructuredText y una macro image de AsciiDoc. La URL estática de shields.io sigue las reglas de escape documentadas: un guion pasa a ser dos guiones, un guion bajo pasa a ser dos guiones bajos y los espacios pasan a ser guiones bajos. La URL solo se genera como texto y nunca se solicita.
Errores comunes y casos límite
Los colores que no sean un nombre reconocido, un valor hex o una tripleta rgb() se ignoran y se usa el predeterminado, lo que evita inyectar marcado en el SVG. Los logotipos deben ser URI de datos SVG o PNG en base64 y se incrustan como imágenes, nunca como marcado sin procesar. El ancho de la insignia es una aproximación, así que fuentes muy inusuales o texto no latino pueden verse algo más anchos que el recuadro. GitHub sirve los SVG de tu repositorio con una política de contenido restrictiva, así que usa la URL raw o la variante de shields.io al insertarlos fuera del repositorio.