Aller au contenu
Tout en local

Générateur de badges markdown

Créez des badges shields.io pour un README et enrobez-les en Markdown, HTML ou reStructuredText.

Badges en lot — une étiquette|valeur|couleur par ligne, pour une rangée de badges
Sortie

Générateur de badges markdown

Chaque README affichant un statut de construction, un numéro de version ou une icône de licence en haut utilise un badge shields.io — une petite image SVG composée d'une étiquette, d'une valeur et d'une couleur. Cet outil construit ce badge pour vous : remplissez l'étiquette, la valeur et la couleur, choisissez un style et un logo optionnel, et il assemblera l'URL shields.io et l'enrobera dans le balisage que votre projet utilise réellement.

L'option de style couvre les cinq rendus shields.io — flat, flat-square, plastic, for-the-badge et social — et le champ logo accepte n'importe quel slug simple-icons (github, npm, docker et des centaines d'autres), teinté avec la couleur du logo quand vous voulez qu'il corresponde au badge. Ajoutez un lien et le badge devient cliquable sur la page rendue ; ajoutez un texte alternatif et il reste significatif pour un lecteur d'écran. Le format de sortie bascule entre Markdown, HTML et reStructuredText, afin que le même badge s'intègre directement dans un README, un site de documentation ou un projet Sphinx sans modifier manuellement le balisage.

Construire plusieurs badges à la fois, c'est ce que la deuxième case est pour : collez une liste, un badge par ligne au format étiquette|valeur|couleur, et l'outil la transforme en une rangée de badges côte à côte — le motif que vous voyez sous un titre de projet avec construction, couverture, version et licence tous en ligne. Activez le tri pour ordonner cette rangée alphabétiquement, ou ajoutez un tableau de badges pour rendre également le même ensemble sous forme de référence à deux colonnes.

Tout s'exécute dans votre navigateur. L'étiquette, la valeur et toute liste en lot que vous collez ne sont utilisées que pour construire une chaîne d'URL localement — rien n'est téléchargé, et l'outil ne contacte jamais shields.io lui-même, il écrit juste le lien. Copiez le résultat, téléchargez-le en tant que fichier .txt, ou envoyez-le à l'entrée d'un autre outil pour continuer l'édition.

FAQ

Qu'est-ce qu'un badge shields.io, exactement ?
C'est une image SVG générée à la demande à partir d'une URL comme https://img.shields.io/badge/label-value-color. Cet outil construit cette URL pour vous et l'enrobe dans le format de balisage dont vous avez besoin.
Pourquoi mon étiquette doit-elle être échappée ?
shields.io lit un tiret comme le séparateur entre étiquette, valeur et couleur. Activez "Échapper les espaces et tirets" et un tiret ou un espace littéral dans votre étiquette est doublé ou remplacé automatiquement pour que l'URL soit toujours analysée correctement.
Comment fonctionne le mode en lot ?
Collez un badge par ligne dans la deuxième case, formaté comme étiquette|valeur|couleur (la couleur est facultative et revient à l'option Couleur). L'outil les rend sous forme d'une rangée de badges côte à côte, prête à coller sous un titre de projet.
Puis-je utiliser une couleur hex personnalisée au lieu d'un nom ?
Oui. Le champ Couleur accepte soit un nom de couleur shields.io comme brightgreen, soit un code hex comme ff69b4 sans le hash initial.
Mon texte de badge est-il téléchargé quelque part ?
Non. L'URL du badge est entièrement assemblée dans votre navigateur à partir des champs que vous remplissez — rien n'est envoyé à un serveur, et cet outil ne contacte jamais shields.io lui-même.