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
- List of Badges, in Markdown
- Table of content
- Generic
- Useful
- Feedback
- Python related
- Go related
- Rust related
- Nix related
- Markdown related
- LaTeX related
- JavaScript related
- GNU Bash related
- Microsoft Visual Studio Code related
- Read the Docs status
- GitHub related
- Bitbucket related
- PackageControl related
- Licenses
- Simple Icons
- Open-Source
- Meta badges ?!
- DOI and Zenodo
- DOI Citations
- Discord
- Jetbrains
- Say thanks
- Custom Logo
- Random
- References ? π
- TODO π₯ ?
- Issues π¦
- Possible TODO? π
- License ? π
[](https://shields.io/)
[](https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity)

[](https://bitbucket.org/lbesson/ansi-colors)
[](http://unmaintained.tech/)
[](http://shields.io/)
[](http://monip.org/)
[](https://perso.crans.org/)
[](https://naereen.github.io/)
[](https://lbesson.bitbucket.io/)
[](http://cv.lbesson.qc.to/)
[](http://fakesite.invalid/)
[](https://GitHub.com/Naereen/ama)
[](https://GitHub.com/Naereen/ama.fr)
Python related
[](https://www.python.org/)
[](https://www.python.org/)
[](https://www.sphinx-doc.org/)
[](https://jupyter.org/try)
[](https://colab.research.google.com/github/Naereen/badges)
[](https://mybinder.org/v2/gh/Naereen/badges/master)
Go related
[](https://go.dev/)
[](https://go.dev/)
GitHub go.mod Go version (/github/go-mod/go-version/:user/:repo
):
[](https://github.com/gomods/athens)
GoDoc reference (godoc.org/:user/go/:repo
):
[](https://godoc.org/nanomsg.org/go/mangos/v2)
GoReportCard (goreportcard.com/badge/github.com/:user/:repo
):
[](https://goreportcard.com/report/github.com/nanomsg/mangos)
Rust related
[](https://www.rust-lang.org/)
[](https://www.rust-lang.org/)
Nix related
[](https://www.nixos.org/)
Markdown related
[](http://commonmark.org)
[](https://GitHub.com/Naereen/StrapDown.js/)
LaTeX related
[](https://www.latex-project.org/)
[](https://www.mathjax.org/)
PyPI downloads
[](https://pypi.python.org/pypi/ansicolortags/)
[](https://pypi.python.org/pypi/ansicolortags/)
[](https://pypi.python.org/pypi/ansicolortags/)
PyPI version
[](https://pypi.python.org/pypi/ansicolortags/)
[](https://pypi.org/project/pip)
[](https://pypi.python.org/pypi/ansicolortags/)
PyPI license
[](https://pypi.python.org/pypi/ansicolortags/)
[](https://pypi.org/project/pip/)
PyPI format
[](https://pypi.python.org/pypi/ansicolortags/)
PyPI python versions
[](https://pypi.python.org/pypi/ansicolortags/)
PyPI implementation
[](https://pypi.python.org/pypi/ansicolortags/)
PyPI status
[](https://pypi.python.org/pypi/ansicolortags/)
JavaScript related
[](https://www.javascript.com)
JSDelivr downloads
[](https://www.jsdelivr.com/package/gh/<USERNAME>/<REPOSITORY>)
[](https://www.jsdelivr.com/package/gh/<USERNAME>/<REPOSITORY>)
[](https://www.jsdelivr.com/)
Npm version
[](https://npmjs.com/package/express)
Npm downloads
[](https://npmjs.com/package/express)
[](https://npmjs.ccom/package/express)
[](https://npmjs.com/package/express)
[](https://npmjs.com/package/express)
[](https://npmjs.com/package/express)
[](https://npmjs.com/package/discord.js)
[](https://npmjs.com/package/express)
GNU Bash related
[](https://github.com/ellerbrock/open-source-badges/)
[](https://www.gnu.org/software/bash/)
NuGet related
[](https://nuget.org/packages/newtonsoft.json)
[](https://nuget.org/packages/newtonsoft.json)
[](https://nuget.org/packages/newtonsoft.json)
Microsoft Visual Studio Code related
[](https://code.visualstudio.com/)
Read the Docs status
[](http://ansicolortags.readthedocs.io/?badge=latest)
[](https://github.com/Naereen/StrapDown.js/blob/master/LICENSE)
[](https://github.com/Naereen/StrapDown.js/blob/master/LICENSE)
[](https://github.com/Naereen/Strapdown.js/)
[](https://GitHub.com/Naereen/StrapDown.js/releases/)
[](https://github.com/Naereen/Strapdown.js/releases)
[](https://GitHub.com/Naereen/StrapDown.js/tags/)
[](https://github.com/Naereen/Strapdown.js/tags/)
[](https://GitHub.com/Naereen/StrapDown.js/commit/)
[](https://GitHub.com/Naereen/StrapDown.js/commit/)
[](https://GitHub.com/Naereen/StrapDown.js/commit/)
[](https://GitHub.com/Naereen/StrapDown.js/releases/)
[](https://GitHub.com/Naereen/StrapDown.js/releases/)
[](https://GitHub.com/Naereen/StrapDown.js/releases/)
[](https://GitHub.com/Naereen/StrapDown.js/network/)
[](https://GitHub.com/Naereen/StrapDown.js/network/)
[](https://GitHub.com/Naereen/StrapDown.js/stargazers/)
[](https://GitHub.com/Naereen/StrapDown.js/stargazers/)
[](https://starchart.cc/Naereen/badges)
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=Naereen/badges)
[](https://GitHub.com/Naereen/StrapDown.js/watchers/)
[](https://GitHub.com/Naereen/StrapDown.js/watchers/)
[](https://github.com/Naereen?tab=followers)
[](https://GitHub.com/Naereen/badges/graphs/contributors/)
[](https://GitHub.com/Naereen/Strapdown.js/graphs/contributors/)
[](https://GitHub.com/Naereen/StrapDown.js/issues/)
[](https://GitHub.com/Naereen/StrapDown.js/issues/)
[](https://github.com/Naereen/StrapDown.js/issues?q=is%3Aopen)
[](https://GitHub.com/Naereen/StrapDown.js/issues?q=is%3Aissue+is%3Aclosed)
[](https://github.com/Naereen/StrapDown.js/issues?q=is%3Aclosed)
[](https://GitHub.com/Naereen/StrapDown.js/issues?q=is%3Aissue+is%3Aopen)
From isitmaintained.com:
[](http://isitmaintained.com/project/Naereen/badges "Average time to resolve an issue")
[](http://isitmaintained.com/project/Naereen/badges "Percentage of issues still open")
[](https://github.com/sinchang/pr-welcome-badge)
[](https://GitHub.com/Naereen/StrapDown.js/pull/)
[](https://GitHub.com/Naereen/StrapDown.js/pull/)
[](https://github.com/Naereen/StrapDown.js/pulls?q=is%3Aopen)
[](https://GitHub.com/Naereen/StrapDown.js/pull/)
[](https://github.com/Naereen/StrapDown.js/pulls?q=is%3Aclosed)
[](https://github.com/Naereen/StrapDown.js/pulls?q=is%3Amerged)
[](http://makeapullrequest.com)
[](https://github.com/Naereen/StrapDown.js)
[](https://github.com/ryo-ma/github-profile-trophy)
[](https://github.com/anuraghazra/github-readme-stats)
[](https://github.com/anuraghazra/github-readme-stats)
[](https://github.com/DenverCoder1/github-readme-streak-stats)
[](https://github.com/ashutosh00710/github-readme-activity-graph)
[](https://stars.medv.io/Naereen/badges)
GitLab related
[](https://gitlab.com/gitlab-org/gitlab-runner)
[](https://gitlab.com/gitlab-org/gitlab-runner)
[](https://gitlab.com/gitlab-org/gitlab-runner)
[](https://gitlab.com/NickBusey/HomelabOS/-/issues?scope=all&state=all&label_name[]=Bug)
[](https://gitlab.com/NickBusey/HomelabOS/-/issues?scope=all&state=open&label_name[]=Bug)
[](https://gitlab.com/NickBusey/HomelabOS/-/issues?scope=all&state=closed&label_name[]=Bug)
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=all)
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=opem)
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=closed)
[](https://gitlab.com/NickBusey/HomelabOS/-/merge_requests?scope=all&state=merged)
[](https://gitlab.com/NickBusey/HomelabOS/-/branches)
[](https://gitlab.com/NickBusey/HomelabOS/-/releases)
[](https://gitlab.com/NickBusey/HomelabOS/-/releases)
[](https://gitlab.com/NickBusey/HomelabOS/-/tags)
[](https://gitlab.com/NickBusey/HomelabOS/-/commits)
[](https://gitlab.com/NickBusey/HomelabOS/-/commits)
Bitbucket related
[](https://Bitbucket.org/lbesson/bin/issues/)
PackageControl related
[](https://packagecontrol.io/packages/SwitchDictionary)
[](https://packagecontrol.io/packages/SwitchDictionary)
[](https://packagecontrol.io/packages/SwitchDictionary)
[](https://packagecontrol.io/packages/SwitchDictionary)
[](https://lbesson.mit-license.org/)
[](http://perso.crans.org/besson/LICENSE.html)
[](http://perso.crans.org/besson/LICENSE.html)
[](https://unlicense.org/)
[](https://creativecommons.org/licenses/by-nd/4.0)
[](http://ForTheBadge.com)
[](https://creativecommons.org/licenses/by-nd/4.0)
[](https://creativecommons.org/licenses/by-nd/4.0)
[](https://creativecommons.org/licenses/by/4.0)
[](https://creativecommons.org/licenses/by/4.0)
[](https://creativecommons.org/licenses/by-nc-sa/4.0)
[](https://creativecommons.org/licenses/by-nc-sa/4.0)
[](https://creativecommons.org/licenses/by-nc/4.0)
[](https://creativecommons.org/licenses/by-nc/4.0)
[](https://creativecommons.org/licenses/by-sa/4.0)
[](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.
[](https://creativecommons.org/licenses/by-nc-sa/2.0/)
[](https://creativecommons.org/licenses/by-nc-sa/2.0/)
[](https://creativecommons.org/licenses/by-nc-sa/2.0/)
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.
[](https://www.vim.org/)
[](https://www.openbsd.org/)
[](https://suckless.org/)
[](https://dwm.suckless.org/)
[](http://git-scm.com/)
[](https://git-scm.com)
[](https://github.com/)
[](https://github.com)
[](https://x.org/)
[](https://visualstudio.microsoft.com/)
[](https://visualstudio.microsoft.com)
[](https://code.visualstudio.com/)
[](https://dotnet.microsoft.com/)
[](https://golang.org/)
[](https://www.javascript.com/)
[](https://www.typescriptlang.org/)
[](https://typescriptlang.org)
[](https://www.figma.com/)
[](https://www.photoshop.com/)
[](https://atom.io)
[](https://azure.microsoft.com)
[](https://bitcoin.org)
[](https://https://www.buymeacoffee.com/)
[](https://https://circleci.com/)
[](https://https://discord.com/)
[](https://https://docker.com/)
[](https://https://eclipse.org/)
[](https://https://gitlab.com/)
[](https://https://jira.com/)
[](https://https://jsdelivr.com/)
[](https://https://maven.apache.org/)
[](https://https://npmjs.com/)
[](https://https://nuget.org/)
[](https://https://patron.com/)
[](https://https://pypi.org/)
[](https://https://ruby-lang.org/)

[](https://travis-ci.org)
[](https://twitter.com)
[](https://microsoft.com/windows/)
[](https://github.com/ellerbrock/open-source-badges/)
[](https://github.com/ellerbrock/open-source-badges/)
[](https://github.com/ellerbrock/open-source-badges/)
[](https://github.com/ellerbrock/open-source-badges/)
[](https://github.com/ellerbrock/open-source-badges/)
[](https://github.com/ellerbrock/open-source-badges/)
[](https://github.com/Naereen/badges/)
This is a badge to show that you like to put badges on your README:
[](https://github.com/Naereen/badges)
This is a badge to link to a DOI:
[](https://doi.org/10.1007/978-3-319-76207-4_15)
This badge is showing the number of citations of a paper / DOI from Google Scholar. Updated daily. See HowTo
[](https://juleskreuer.eu/citation-badge/)
Discord Badges
[](https://discord.gg/vpEv3HJ)
[](https://discord.gg/vpEv3HJ)
[](https://discord.gg/vpEv3HJ)
[](https://discord.gg/csharp)
[](https://discord.gg/csharp)
Jetbrains Badges
[](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
[](https://plugins.jetbrains.com/)
A nice badge to give a link to saythanks.io/to/kennethreitz (for example).
[](https://saythanks.io/to/kennethreitz)
How to Create
- Search a SVG image logo
- Some databases:
- Optimize the SVG image using a tool:
- Example of tool:
- Encode the Optimized SVG to Base64 using a tool:
- Example of tool:
- Place the B64 code after the code:
https://img.shields.io/badge/<SUBJECT>-<STATUS>-<COLOR>?logo=data:image/svg%2bxml;base64,
- Use in your README.md
(Source)

(Source)

(Source)

(Source)

(Source)

(Source)

[](http://ForTheBadge.com)

[](https://twitter.com/javascript)
[](https://GitHub.com/Naereen/)
[](https://GitHub.com/Naereen/)
[](https://GitHub.com/Naereen/)
[](https://GitHub.com/Naereen/)
[](http://ForTheBadge.com)
[](https://GitHub.com/)
[](http://ForTheBadge.com)
[](http://ForTheBadge.com)
[](http://ForTheBadge.com)
[](http://ForTheBadge.com)
[](http://ForTheBadge.com)
[](http://ForTheBadge.com)
- The powerful Shields.io API and website π
- The nice LicenseButtons.net website for licence badges π
- This repo open-source-badges by @ellerbrock, for open-source badges π
- This small repo awesome-badges by @bevacqua, for awesome and meta badges β°
- Repology.org has one huge badge to track your project's distribution and few smaller ones. For example, the
binutils
project badge. - And of course, the magical ForTheBadge.com website for random badges β¨
- Finish this list
- Update link for the real resource that should get linked to
- Update all my README.md to add nice badges
- Smaller size (badge size) for some ForTheBadge.com badges? (with-science, winter-is-coming, made-with-python, all the creative-commons)
- 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 ?
MIT Licensed (file LICENSE). Β© Lilian Besson and contributors, 2016-23.