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
- Markdown related
- LaTeX related
- JavaScript related
- GNU Bash related
- Microsoft Visual Studio Code related
- Read the Docs status
- GitHub related
- GitHub license
- GitHub versions/tags/commits
- GitHub downloads
- GitHub forks
- GitHub stars
- GitHub Stargazers over time
- GitHub watchers
- GitHub followers
- GitHub contributors
- GitHub issues
- GitHub Pull Requests
- GitHub Make a Pull Requests
- GitHub file size
- GitHub version
- GitHub hits
- GitHub Profile
- GitHub Stars Sparklines
- Bitbucket related
- PackageControl related
- Google Analytics
- Licenses
- Simple Icons
- Open-Source
- Meta badges ?!
- DOI and Zenodo
- Discord
- Jetbrains
- Say thanks
- Custom Logo
- Random
- References ? 📓
- TODO 💥 ?
- Issues 💦
- Possible TODO? 🚈
- License ? 📜
[](https://shields.io/)Maintained:
[](https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity)Maintainer:
Not maintained:
[](https://bitbucket.org/lbesson/ansi-colors)Worse:
[](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://myfakewebsitethatshouldnotexist.at.least.i.hope/)
[](https://svgshare.com/i/Zhy.svg)
[](https://svgshare.com/i/ZjP.svg)
[](https://svgshare.com/i/ZhY.svg)[](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://binder.pangeo.io/v2/gh/Naereen/badges/master)Go related
[](http://golang.org)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)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.com/project/pip)
[](https://pypi.python.org/pypi/ansicolortags/)PyPI license
[](https://pypi.python.org/pypi/ansicolortags/)[](https://pypi.com/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://marketplace.visualstudio.com/items?itemName=naereen.makefiles-support-for-vscode)
[](https://marketplace.visualstudio.com/items?itemName=naereen.makefiles-support-for-vscode)
[](https://marketplace.visualstudio.com/items?itemName=naereen.makefiles-support-for-vscode)
[](https://code.visualstudio.com/)
[](https://open.vscode.dev/Naereen/badges)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/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)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/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/blob/master/strapdown.min.js)
[](https://github.com/Naereen/StrapDown.js)
[](http://hits.dwyl.io/Naereen/badges)[](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://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)Warning: don't forget to change your Google Analytics code, from
UA-XXXXXXXX-XXto yours!
[](https://GitHub.com/Naereen/badges/)[](https://GitHub.com/Naereen/badges/)
[](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/)[Terminal](https://badgen.net/badge/icon/terminal?icon=terminal&label)[](https://travis-ci.org)[](https://twitter.com)[](https://microsoft.com/windows/)Version 1, in SVG:
[](https://github.com/ellerbrock/open-source-badges/)Version 1, in PNG:
[](https://github.com/ellerbrock/open-source-badges/)Version 2, in SVG:
[](https://github.com/ellerbrock/open-source-badges/)Version 2, in PNG:
[](https://github.com/ellerbrock/open-source-badges/)Version 3, in SVG:
[](https://github.com/ellerbrock/open-source-badges/)Version 3, in PNG:
[](https://github.com/ellerbrock/open-source-badges/)Open Source? Yes!
[](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)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
[](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 ➰
- 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, 2016-18.
