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)
Maintaner:
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/)
[](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/)
JavaScript related
[](https://www.javascript.com)
JSDelivr downloads
[](https://www.jsdelivr.com/package/gh/<USERNAME>/<REPOSITORY>)
[](https://www.jsdelivr.com/package/gh/<USERNAME>/<REPOSITORY>)
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/)
[](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/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://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=Naereen/badges)
[](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/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/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)
[](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://x.org/)
[](https://visualstudio.microsoft.com/)
[](https://golang.org/)
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)
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://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.