Genere Markdown para insignias README con texto alternativo

El generador devuelve por separado el Markdown completo, la URL de la imagen y un texto alternativo legible. Procesa de forma segura espacios, guiones, guiones bajos, signos y corchetes con significado en Markdown, de modo que el resultado conserva una estructura válida incluso con nombres reales de tareas o canales de publicación. Use la herramienta del navegador para una insignia puntual o llame a la API determinista al generar documentación automáticamente.

Elija un texto breve que comunique el estado

Una insignia útil responde de inmediato a una pregunta pequeña y concreta. Coloque la categoría a la izquierda como etiqueta y su valor actual a la derecha como mensaje. Por ejemplo, una etiqueta como compilación junto a un mensaje como correcta se distingue mejor que una frase larga comprimida en una imagen. El texto alternativo generado une ambos valores mediante dos puntos, por lo que las personas que usan lectores de pantalla reciben la misma relación básica que se presenta visualmente. Procure que los dos valores conserven su significado sin depender del color, ya que este nunca debería ser el único medio de comunicar un estado esencial. El generador elimina los espacios exteriores, pero mantiene las palabras y mayúsculas elegidas. Rechaza etiquetas y mensajes vacíos para evitar imágenes confusas con una mitad en blanco. Si la insignia representa automatización, mantenga un vocabulario estable entre versiones para que los cambios sean legibles. El campo alt_text permite además revisar o reutilizar la descripción accesible sin separar el Markdown final.

Comprenda cómo se forma la URL de Shields

Las insignias estáticas de Shields codifican la etiqueta, el mensaje y el color dentro de la ruta de una imagen. Esa ruta aplica reglas especiales a sus separadores: los espacios se convierten en guiones bajos, los guiones bajos literales se duplican y los guiones literales también se duplican para no confundirlos con las divisiones entre las partes. Los demás signos se codifican porcentualmente para obtener una URL válida. Esta capacidad aplica dichas transformaciones de manera determinista y devuelve la URL resultante junto al Markdown. Puede indicar un color hexadecimal con almohadilla inicial; esta se elimina antes de incorporar el valor a la ruta. También puede usar directamente nombres de color de Shields como brightgreen. El servicio no se conecta con Shields ni comprueba cómo se representa un nombre de color concreto. Solo genera la referencia convencional a la imagen, por lo que la ejecución es rápida, privada y adecuada para compilaciones de documentación sin conexión. Un resultado correcto confirma la sintaxis generada, no la descarga de la imagen remota.

Inserte y automatice el Markdown de forma segura

Copie el campo markdown en un README, una plantilla de solicitud de cambios, una página de paquete o cualquier documento Markdown que admita imágenes remotas. El resultado utiliza el formato conocido de imagen, con texto accesible entre corchetes y la URL de Shields entre paréntesis. Los corchetes y las barras inversas del texto visible se escapan para que una frase aportada por el usuario no cierre antes de tiempo la sección de texto alternativo. En un flujo automatizado, envíe los tres campos de entrada al representar la documentación y escriba el valor markdown devuelto en la ubicación prevista. Como el algoritmo no depende de la hora, del azar, del estado ni de la red, entradas idénticas siempre producen salidas idénticas; así, los archivos generados permanecen estables en el control de versiones. Conserve la posición y el orden de las insignias en su propia plantilla. Esta capacidad crea deliberadamente un solo elemento por solicitud: no edita repositorios, no consulta compilaciones ni decide qué estado corresponde. La automatización de origen aporta el dato verdadero y este generador se ocupa de codificarlo y presentarlo correctamente.