Hoppa till innehåll
100% lokalt

Markdown-badge-generator

Skapa shields.io-badges för en README och slå in dem i Markdown, HTML eller reStructuredText.

Flera badges — en etikett|värde|färg per rad för en rad badges
Utmatning

Markdown-badge-generator

Varje README med en build-status, versionsnummer eller licensikon högst upp använder en shields.io-badge — en liten SVG sammanställd från en etikett, värde och färg. Detta verktyg bygger den badgen åt dig: fyll i etiketten, värdet och färgen, välj en stil och valfri logotyp, och det sätter ihop shields.io-URL:en och slår in den i det markup din projekt faktiskt använder.

Stilalternativet täcker alla fem shields.io-renderingar — platt, platt kvadrat, plast, för badgen och socialt — och logofältet accepterar valfritt simple-icons slug (github, npm, docker och hundratals fler), färgad med logofärg när du vill att den ska matcha badgen. Lägg till en länk och badgen blir klickbar på den renderade sidan; lägg till alt-text och den förblir meningsfull för en skärmläsare. Utdataformat växlar mellan Markdown, HTML och reStructuredText, så samma badge går direkt in i en README, en docs-sajt eller ett Sphinx-projekt utan att manuellt redigera markup.

Att bygga mer än en badge åt gången är vad den andra rutan är för: klistra in en lista, en badge per rad som etikett|värde|färg, och verktyget förvandlar den till en rad badges sida vid sida — mönstret du ser under en projekttitel med build, coverage, version och licens allt i en rad. Slå på sortering för att ordna den raden alfabetiskt, eller lägg till en badge-tabell för att också rendera samma set som en tvåkolumners referens. Escape-alternativet hanterar den shields.io-egenhet som förvirrar folk: ett bokstavligt streck eller mellanslag i en etikett måste fördubblas eller bytas ut innan URL:en är giltig, och det här verktyget gör det automatiskt om du inte stänger av det.

Allt körs i din webbläsare. Etiketten, värdet och någon bulk-lista du klistrar in används bara för att bygga en URL-sträng lokalt — ingenting laddas upp, och det här verktyget kontaktar aldrig shields.io själv, det skriver bara länken. Kopiera resultatet, ladda ned det som en .txt-fil, eller skicka det till en annan verktygs inmatning för att fortsätta redigera.

FAQ

Vad är exakt en shields.io-badge?
Det är en SVG-bild som genereras på begäran från en URL som https://img.shields.io/badge/label-value-color. Det här verktyget bygger den URL:en åt dig och slår in den i det markup-format du behöver.
Varför måste min etikett undantas?
shields.io läser ett streck som separator mellan etikett, värde och färg. Slå på "Undanta mellanslag och bindestreck" och ett bokstavligt streck eller mellanslag i din etikett fördubblas eller ersätts automatiskt så att URL:en fortfarande tolkas korrekt.
Hur fungerar bulk-läget?
Klistra in en lista i den andra rutan, en badge per rad formaterad som etikett|värde|färg (färgen är valfri och faller tillbaka på färgalternativet). Verktyget renderar dem som en rad badges sida vid sida, redo att klistra in under en projekttitel.
Kan jag istället använda en anpassad hexfärg?
Ja. Färgfältet accepterar antingen ett shields.io-färgnamn som brightgreen eller en hexkod som ff69b4 utan det ledande #.
Laddas min badge-text upp någonstans?
Nej. Badge-URL:en sätts ihop helt i din webbläsare från fälten du fyller i — ingenting skickas till en server, och det här verktyget kontaktar aldrig shields.io själv.