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
- GNU Bash related
- Microsoft Visual Studio Code related
- Read the Docs status
- GitHub related
- Bitbucket related
- PackageControl related
- Google Analytics
- Licenses
- Open-Source
- Meta badges ?!
- DOI and Zenodo
- Discord
- Jetbrains
- Say thanks
- Random
- References ? 📓
- TODO 💥 ?
- Issues 💦
- Possible TODO? 🚈
- License ? 📜
[](https://shields.io/)Maintained:
[](https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity)Maintaner:
Not maintained:
[](https://bitbucket.org/lbesson/ansi-colors)Worse:
[](http://unmaintained.tech/)
[](http://shields.io/)
[](http://monip.org/)
[](http://perso.crans.org/)
[](https://naereen.github.io/)
[](http://lbesson.bitbucket.org/)
[](http://cv.lbesson.qc.to/)
[](http://myfakewebsitethatshouldnotexist.at.least.i.hope/)
[](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/)
[](https://pypi.python.org/pypi/ansicolortags/)PyPI version
[](https://pypi.python.org/pypi/ansicolortags/)
[](https://pypi.python.org/pypi/ansicolortags/)PyPI license
[](https://pypi.python.org/pypi/ansicolortags/)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/)GNU Bash related
[](https://github.com/ellerbrock/open-source-badges/)
[](https://www.gnu.org/software/bash/)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/)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/releases/)
[](https://GitHub.com/Naereen/StrapDown.js/tags/)
[](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/stargazers/)
[](https://starchart.cc/Naereen/badges)
[](https://GitHub.com/Naereen/StrapDown.js/watchers/)
[](https://github.com/Naereen?tab=followers)
[](https://GitHub.com/Naereen/StrapDown.js/graphs/contributors/)
[](https://GitHub.com/Naereen/StrapDown.js/issues/)
[](https://GitHub.com/Naereen/StrapDown.js/issues?q=is%3Aissue+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/)
[](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/anuraghazra/github-readme-stats)
[](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://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)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)And this is a meta badge : "some people like repo badges so this is a badge to count your repo badges":
[](https://github.com/defunctzombie/badginator)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)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)
[](http://ForTheBadge.com)
[](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)
----
## References ? :notebook:
- The powerful [Shields.io](https://shields.io) API and website :rocket:
- The nice [LicenseButtons.net](https://licensebuttons.net/) website for licence badges :scroll:
- This repo [open-source-badges](https://github.com/ellerbrock/open-source-badges/) by [@ellerbrock](https://github.com/ellerbrock), for open-source badges :books:
- This small repo [awesome-badges](https://github.com/bevacqua/awesome-badges) by [@bevacqua](https://github.com/bevacqua/), for awesome and meta badges :curly_loop:
- And of course, the magical [ForTheBadge.com](http://ForTheBadge.com/) website for random badges :sparkles:
## TODO :boom: ?
- [X] Finish this list
- [X] Update link for the *real resource* that should get linked to
- [X] Update all my README.md to add nice badges
## Issues :sweat_drops:
- [ ] Smaller size (badge size) for some [ForTheBadge.com](http://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](https://lbesson.mit-license.org/) (file [LICENSE](LICENSE)).
© [Lilian Besson](https://GitHub.com/Naereen), 2016-18.
[](https://github.com/Naereen/badges)
[](https://GitHub.com/Naereen/badges/graphs/commit-activity)
[](https://GitHub.com/Naereen/ama)
[](https://GitHub.com/Naereen/badges/)
[](https://github.com/ellerbrock/open-source-badges/)
[](https://GitHub.com/Naereen/)
[](http://ForTheBadge.com)
[](https://GitHub.com/)