badges Documentation

Pencil: Markdown code for lots of small badges :ribbon: :pushpin: (shields.io, forthebadge.com etc) :sunglasses:. Contributions are welcome! Please add yours!

RAW Doc

Technical Documentation: Naereen/badges

โ„น๏ธ Provenance: Multi-Tier Ingestion ยท CodeWiki Reference

Overview (`README.md`)

List of Badges, in Markdown

A list of badges, with their Markdown code, that can be included in a README.md file for a GitHub or Bitbucket project.

The same file for reStructuredText code is available here: README.rst.

Table of content

Table of content


Generic

markdown
[](https://shields.io/)

Useful

Maintained?

Maintained:

markdown
[](https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity)

Maintainer:

markdown

Not maintained:

markdown
[](https://bitbucket.org/lbesson/ansi-colors)

Worse:

text
[](http://unmaintained.tech/)

Related Repos:

markdown
[](https://relatedrepos.com/gh/<owner>/<repo>)

[Website up/down](http://isup.me/)

markdown
[](http://shields.io/)

markdown
[](http://monip.org/)

markdown
[](https://perso.crans.org/)

markdown
[](https://naereen.github.io/)

markdown
[](https://lbesson.bitbucket.io/)

markdown
[](http://cv.lbesson.qc.to/)

markdown
[](http://fakesite.invalid/)

Feedback

*"Ask me anything"* in English

markdown
[](https://GitHub.com/Naereen/ama)

*"Demandez moi n'importe quoi"* in French

markdown
[](https://GitHub.com/Naereen/ama.fr)

markdown
[](https://www.python.org/)

markdown
[](https://www.python.org/)

markdown
[](https://www.sphinx-doc.org/)

[Jupyter Notebook](https://jupyter.org)

markdown
[](https://jupyter.org/try)

[Google Collab](https://colab.research.google.com/notebooks/intro.ipynb)

markdown
[](https://colab.research.google.com/github/Naereen/badges)

[Binder](https://mybinder.org/)

markdown
[](https://mybinder.org/v2/gh/Naereen/badges/master)

markdown
[](https://go.dev/)

markdown
[](https://go.dev/)

GitHub go.mod Go version (/github/go-mod/go-version/:user/:repo):

markdown
[](https://github.com/gomods/athens)

GoDoc reference (godoc.org/:user/go/:repo):

markdown
[](https://godoc.org/nanomsg.org/go/mangos/v2)

GoReportCard (goreportcard.com/badge/github.com/:user/:repo):

markdown
[](https://goreportcard.com/report/github.com/nanomsg/mangos)

markdown
[](https://www.rust-lang.org/)

markdown
[](https://www.rust-lang.org/)

markdown
[](https://www.nixos.org/)

markdown
[](http://commonmark.org)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/)

markdown
[](https://www.latex-project.org/)

markdown
[](https://www.mathjax.org/)

[PyPI](https://pypi.python.org/) downloads

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

[PyPI](https://pypi.python.org/) version

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

markdown
[](https://pypi.org/project/pip)

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

[PyPI](https://pypi.python.org/) license

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

markdown
[](https://pypi.org/project/pip/)

[PyPI](https://pypi.python.org/) format

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

[PyPI](https://pypi.python.org/) python versions

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

[PyPI](https://pypi.python.org/) implementation

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

[PyPI](https://pypi.python.org/) status

markdown
[](https://pypi.python.org/pypi/ansicolortags/)

markdown
[](https://www.javascript.com)

[JSDelivr](https://www.jsdelivr.com/) downloads

markdown
[](https://www.jsdelivr.com/package/gh/<USERNAME>/<REPOSITORY>)

markdown
[](https://www.jsdelivr.com/package/gh/<USERNAME>/<REPOSITORY>)

markdown
[](https://www.jsdelivr.com/)

[Npm](https://npmjs.com) version

markdown
[](https://npmjs.com/package/express)

[Npm](https://npmjs.com) downloads

markdown
[](https://npmjs.com/package/express)

markdown
[](https://npmjs.ccom/package/express)

markdown
[](https://npmjs.com/package/express)

markdown
[](https://npmjs.com/package/express)

Miscellaneous

markdown
[](https://npmjs.com/package/express)

markdown
[](https://npmjs.com/package/discord.js)

markdown
[](https://npmjs.com/package/express)

markdown
[](https://github.com/ellerbrock/open-source-badges/)

markdown
[](https://www.gnu.org/software/bash/)

markdown
[](https://nuget.org/packages/newtonsoft.json)

markdown
[](https://nuget.org/packages/newtonsoft.json)

markdown
[](https://nuget.org/packages/newtonsoft.json)

markdown
[](https://code.visualstudio.com/)

[Read the Docs](https://readthedocs.org/) status

markdown
[](http://ansicolortags.readthedocs.io/?badge=latest)

GitHub license

markdown
[](https://github.com/Naereen/StrapDown.js/blob/master/LICENSE)

markdown
[](https://github.com/Naereen/StrapDown.js/blob/master/LICENSE)

GitHub branches

markdown
[](https://github.com/Naereen/Strapdown.js/)

GitHub versions/tags/commits

markdown
[](https://GitHub.com/Naereen/StrapDown.js/releases/)

markdown
[](https://github.com/Naereen/Strapdown.js/releases)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/tags/)

markdown
[](https://github.com/Naereen/Strapdown.js/tags/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/commit/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/commit/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/commit/)

GitHub downloads

markdown
[](https://GitHub.com/Naereen/StrapDown.js/releases/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/releases/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/releases/)

GitHub forks

markdown
[](https://GitHub.com/Naereen/StrapDown.js/network/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/network/)

GitHub stars

markdown
[](https://GitHub.com/Naereen/StrapDown.js/stargazers/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/stargazers/)

GitHub Stargazers over time

markdown
[](https://starchart.cc/Naereen/badges)

GitHub watchers

markdown
[](https://GitHub.com/Naereen/StrapDown.js/watchers/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/watchers/)

GitHub followers

markdown
[](https://github.com/Naereen?tab=followers)

GitHub contributors

markdown
[](https://GitHub.com/Naereen/badges/graphs/contributors/)

markdown
[](https://GitHub.com/Naereen/Strapdown.js/graphs/contributors/)

GitHub issues

markdown
[](https://GitHub.com/Naereen/StrapDown.js/issues/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/issues/)

markdown
[](https://github.com/Naereen/StrapDown.js/issues?q=is%3Aopen)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/issues?q=is%3Aissue+is%3Aclosed)

markdown
[](https://github.com/Naereen/StrapDown.js/issues?q=is%3Aclosed)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/issues?q=is%3Aissue+is%3Aopen)

From isitmaintained.com:

markdown
[](http://isitmaintained.com/project/Naereen/badges "Average time to resolve an issue")

markdown
[](http://isitmaintained.com/project/Naereen/badges "Percentage of issues still open")

GitHub Pull Requests

markdown
[](https://github.com/sinchang/pr-welcome-badge)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/pull/)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/pull/)

markdown
[](https://github.com/Naereen/StrapDown.js/pulls?q=is%3Aopen)

markdown
[](https://GitHub.com/Naereen/StrapDown.js/pull/)

markdown
[](https://github.com/Naereen/StrapDown.js/pulls?q=is%3Aclosed)

markdown
[](https://github.com/Naereen/StrapDown.js/pulls?q=is%3Amerged)

GitHub Make a Pull Requests

markdown
[](http://makeapullrequest.com)

GitHub version

markdown
[](https://github.com/Naereen/StrapDown.js)

GitHub Profile

markdown
[](https://github.com/ryo-ma/github-profile-trophy)

markdown
[](https://github.com/anuraghazra/github-readme-stats)

markdown
[](https://github.com/anuraghazra/github-readme-stats)

markdown
[](https://github.com/DenverCoder1/github-readme-streak-stats)

markdown
[](https://github.com/ashutosh00710/github-readme-activity-graph)

GitHub Stars Sparklines

markdown
[](https://stars.medv.io/Naereen/badges)

Gitlab issues

markdown
[](https://gitlab.com/gitlab-org/gitlab-runner)

markdown
[](https://gitlab.com/gitlab-org/gitlab-runner)

markdown
[](https://gitlab.com/gitlab-org/gitlab-runner)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/issues?scope=all&state=all&label_name[]=Bug)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/issues?scope=all&state=open&label_name[]=Bug)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/issues?scope=all&state=closed&label_name[]=Bug)

MR's

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=all)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=opem)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=closed)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=merged)

Branches

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/branches)

Releases

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/releases)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/releases)

Tags

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/tags)

Commits

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/commits)

markdown
[](https://gitlab.com/NickBusey/HomelabOS/-/commits)

Bitbucket issues

markdown
[](https://Bitbucket.org/lbesson/bin/issues/)

markdown
[](https://packagecontrol.io/packages/SwitchDictionary)

markdown
[](https://packagecontrol.io/packages/SwitchDictionary)

markdown
[](https://packagecontrol.io/packages/SwitchDictionary)

markdown
[](https://packagecontrol.io/packages/SwitchDictionary)

Licenses

MIT License

markdown
[](https://lbesson.mit-license.org/)

GPLv3 License

markdown
[](http://perso.crans.org/besson/LICENSE.html)

markdown
[](http://perso.crans.org/besson/LICENSE.html)

Unlicense

markdown
[](https://unlicense.org/)

[Creative Commons Licenses](https://creativecommons.org/licenses/)

markdown
[](https://creativecommons.org/licenses/by-nd/4.0)

markdown
[](http://ForTheBadge.com)

markdown
[](https://creativecommons.org/licenses/by-nd/4.0)

markdown
[](https://creativecommons.org/licenses/by-nd/4.0)

markdown
[](https://creativecommons.org/licenses/by/4.0)

markdown
[](https://creativecommons.org/licenses/by/4.0)

markdown
[](https://creativecommons.org/licenses/by-nc-sa/4.0)

markdown
[](https://creativecommons.org/licenses/by-nc-sa/4.0)

markdown
[](https://creativecommons.org/licenses/by-nc/4.0)

markdown
[](https://creativecommons.org/licenses/by-nc/4.0)

markdown
[](https://creativecommons.org/licenses/by-sa/4.0)

markdown
[](https://creativecommons.org/licenses/by-sa/4.0)

The Creative Commons License Buttons site also
provides a customizable way to access badges in various colours or sizes.

markdown
[](https://creativecommons.org/licenses/by-nc-sa/2.0/)

markdown
[](https://creativecommons.org/licenses/by-nc-sa/2.0/)

markdown
[](https://creativecommons.org/licenses/by-nc-sa/2.0/)

Simple Icons

Any shields.io badge can use a logo image by adding the
logo query parameter to the name of any logo suported by
Simple Icons.

markdown
[](https://www.vim.org/)

markdown
[](https://www.openbsd.org/)

markdown
[](https://suckless.org/)

markdown
[](https://dwm.suckless.org/)

markdown
[](http://git-scm.com/)

markdown
[](https://git-scm.com)

markdown
[](https://github.com/)

markdown
[](https://github.com)

markdown
[](https://x.org/)

markdown
[](https://visualstudio.microsoft.com/)

markdown
[](https://visualstudio.microsoft.com)

markdown
[](https://code.visualstudio.com/)

markdown
[](https://dotnet.microsoft.com/)

markdown
[](https://golang.org/)

markdown
[](https://www.javascript.com/)

markdown
[](https://www.typescriptlang.org/)

markdown
[](https://typescriptlang.org)

markdown
[](https://www.figma.com/)

markdown
[](https://www.photoshop.com/)

markdown
[](https://atom.io)

markdown
[](https://azure.microsoft.com)

markdown
[](https://bitcoin.org)

markdown
[](https://https://www.buymeacoffee.com/)

markdown
[](https://https://circleci.com/)

markdown
[](https://https://discord.com/)

markdown
[](https://https://docker.com/)

markdown
[](https://https://eclipse.org/)

markdown
[](https://https://gitlab.com/)

markdown
[](https://https://jira.com/)

markdown
[](https://https://jsdelivr.com/)

markdown
[](https://https://maven.apache.org/)

markdown
[](https://https://npmjs.com/)

markdown
[](https://https://nuget.org/)

markdown
[](https://https://patron.com/)

markdown
[](https://https://pypi.org/)

markdown
[](https://https://ruby-lang.org/)
markdown

markdown
[](https://travis-ci.org)

markdown
[](https://twitter.com)

markdown
[](https://microsoft.com/windows/)

Open-Source

Version 1, in SVG:

markdown
[](https://github.com/ellerbrock/open-source-badges/)

Version 1, in PNG:

markdown
[](https://github.com/ellerbrock/open-source-badges/)

Version 2, in SVG:

markdown
[](https://github.com/ellerbrock/open-source-badges/)

Version 2, in PNG:

markdown
[](https://github.com/ellerbrock/open-source-badges/)

Version 3, in SVG:

markdown
[](https://github.com/ellerbrock/open-source-badges/)

Version 3, in PNG:

markdown
[](https://github.com/ellerbrock/open-source-badges/)

Open Source? Yes!

markdown
[](https://github.com/Naereen/badges/)

Meta badges ?!

This is a badge to show that you like to put badges on your README:

markdown
[](https://github.com/Naereen/badges)

DOI and Zenodo

This is a badge to link to a DOI:

markdown
[](https://doi.org/10.1007/978-3-319-76207-4_15)

DOI Citations

This badge is showing the number of citations of a paper / DOI from Google Scholar. Updated daily. See HowTo

markdown
[](https://juleskreuer.eu/citation-badge/)

Discord

Discord Badges

markdown
[](https://discord.gg/vpEv3HJ)

markdown
[](https://discord.gg/vpEv3HJ)

markdown
[](https://discord.gg/vpEv3HJ)

markdown
[](https://discord.gg/csharp)

markdown
[](https://discord.gg/csharp)

Jetbrains

Jetbrains Badges

markdown
[](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)

markdown
[](https://plugins.jetbrains.com/)

[Say thanks](https://github.com/kennethreitz/saythanks.io/)

A nice badge to give a link to saythanks.io/to/kennethreitz (for example).

markdown
[](https://saythanks.io/to/kennethreitz)

How to Create

Step by Step

  1. Search a SVG image logo
  2. Optimize the SVG image using a tool:
  3. Encode the Optimized SVG to Base64 using a tool:
  4. Place the B64 code after the code:
    markdown
    https://img.shields.io/badge/<SUBJECT>-<STATUS>-<COLOR>?logo=data:image/svg%2bxml;base64,
  5. Use in your README.md

(Source)

markdown

(Source)

markdown

(Source)

markdown

(Source)

markdown

(Source)

markdown

(Source)

markdown

Random

Ages 20-30...

markdown
[](http://ForTheBadge.com)

Tweeting

markdown

markdown
[](https://twitter.com/javascript)

Built by...

markdown
[](https://GitHub.com/Naereen/)

Built with...

markdown
[](https://GitHub.com/Naereen/)

markdown
[](https://GitHub.com/Naereen/)

markdown
[](https://GitHub.com/Naereen/)

Uses...

markdown
[](http://ForTheBadge.com)

markdown
[](https://GitHub.com/)

markdown
[](http://ForTheBadge.com)

markdown
[](http://ForTheBadge.com)

markdown
[](http://ForTheBadge.com)

Fun

markdown
[](http://ForTheBadge.com)

markdown
[](http://ForTheBadge.com)

markdown
[](http://ForTheBadge.com)

References ? :notebook:

TODO :boom: ?

  • Finish this list
  • Update link for the real resource that should get linked to
  • Update all my README.md to add nice badges

Issues :sweat_drops:

  • Smaller size (badge size) for some ForTheBadge.com badges? (with-science, winter-is-coming, made-with-python, all the creative-commons)

Possible TODO? :light_rail:

  • Download here a copy of every png/svg file, only for the static badges
  • Host the badges in this repo, and not on an external web service ?

License ? :scroll: [](https://github.com/Naereen/badges/blob/master/LICENSE)

MIT Licensed (file LICENSE).
ยฉ Lilian Besson and contributors, 2016-23.






--- METRICS ---