Saltar al contenido
Totalmente local

Generador de insignias markdown

Crea insignias shields.io para un README y envuélvelas en Markdown, HTML o reStructuredText.

Insignias en lote — una etiqueta|valor|color por línea, para una fila de insignias
Salida

Generador de insignias markdown

Todo README que muestre un estado de compilación, número de versión o icono de licencia en la parte superior usa una insignia shields.io — una pequeña imagen SVG compuesta por una etiqueta, un valor y un color. Esta herramienta construye esa insignia por ti: rellena la etiqueta, el valor y el color, elige un estilo y un logo opcional, y armará la URL de shields.io y la envolverá en el marcado que tu proyecto realmente usa.

La opción de estilo cubre los cinco tipos de renderizado de shields.io — flat, flat-square, plastic, for-the-badge y social — y el campo logo acepta cualquier slug de simple-icons (github, npm, docker y cientos más), teñido con el color del logo cuando quieras que coincida con la insignia. Agrega un enlace y la insignia se vuelve clickeable en la página renderizada; agrega texto alternativo y permanece significativa para un lector de pantalla. El formato de salida cambia entre Markdown, HTML y reStructuredText, para que la misma insignia se ajuste directamente a un README, un sitio de documentación o un proyecto Sphinx sin editar manualmente el marcado.

Construir más de una insignia a la vez es para lo que sirve el segundo cuadro: pega una lista, una insignia por línea como etiqueta|valor|color, y la herramienta la convierte en una fila de insignias lado a lado — el patrón que ves bajo un título de proyecto con compilación, cobertura, versión y licencia todos en una línea. Activa la ordenación para ordenar alfabéticamente esa fila, o agrega una tabla de insignias para renderizar también el mismo conjunto como una referencia de dos columnas.

Todo se ejecuta en tu navegador. La etiqueta, el valor y cualquier lista en lote que pegues solo se usan para construir una cadena de URL localmente — nada se carga, y la herramienta nunca contacta a shields.io en sí, solo escribe el enlace. Copia el resultado, descárgalo como archivo .txt, o envíalo a la entrada de otra herramienta para seguir editando.

Preguntas frecuentes

¿Qué es exactamente una insignia shields.io?
Es una imagen SVG generada bajo demanda a partir de una URL como https://img.shields.io/badge/label-value-color. Esta herramienta construye esa URL para ti y la envuelve en el formato de marcado que necesitas.
¿Por qué mi etiqueta necesita escapar?
shields.io lee un guión como el separador entre etiqueta, valor y color. Activa "Escapar espacios y guiones" y un guión o espacio literal en tu etiqueta se duplica o se reemplaza automáticamente para que la URL siga analizándose correctamente.
¿Cómo funciona el modo en lote?
Pega una insignia por línea en el segundo cuadro, formateada como etiqueta|valor|color (el color es opcional y se vuelve predeterminado a la opción Color). La herramienta las renderiza como una fila de insignias lado a lado, lista para pegar bajo un título de proyecto.
¿Puedo usar un color hex personalizado en lugar de un nombre?
Sí. El campo Color acepta un nombre de color shields.io como brightgreen o un código hex como ff69b4 sin el almohadilla inicial.
¿Mi texto de insignia se carga en algún lugar?
No. La URL de la insignia se ensambla completamente en tu navegador a partir de los campos que rellenas — nada se envía a un servidor, y esta herramienta nunca contacta a shields.io en sí.