DevToys Web Pro iconDevToys Web ProBlog
Califícanos:
Prueba la extensión del navegador:

Generador de insignias (SVG estilo Shields)

Preajustes
Estilo
Logotipo (URI de datos SVG o PNG)

Vista previa

build: passing

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.