π‘οΈ π¦‘ π§
Badge Generator Magically generate Markdown badges for your docs
Website β Sample badges β Documentation
Overview
A convenience tool that makes it easy to generate custom Markdown for badges to put on your documentation or website.
Choose a page, enter your details, and click Submit to generate some Markdown code for you to copy and paste.
External tools are used to actually render badges - mostly using shields.io.
Preview
Open the web app
Start creating badges for your docs.
Sample badges
Examples of a few badges generated with the app and rendered here on a markdown doc
Note that most of the badges at the top of this README.md
file were also generated using this app.
Social badges
Link to your project. From another project - even paste these in an online forum or your blog.
Repo metadata
Add to the top of your README.md
file. These are tied to your specific repo.
Generic
Put whatever text you want in this static badge, which is independent of a repo. You can change the color, logo and destination link.
Dynamic data
Create a badge that references any value within a public data file (currently only JSON supported). It will always stay up to date.
In the example below, we look-up the required VS Code version for a VS Code extension by using the $.engines["vscode"]
query against this package.json file on a GitHub repo.
Packages
An NPM package badge that changes magically when your package.json
file is updated.
Catalogue
Pre-made badges around languages and tools. Just copy and paste. If you can't find a badge you're looking for, use the Generic badge option to make your own.
[
](https://nodejs.org "Go to node.js homepage)
Documentation
User guide for using the app and how setup and run the app yourself
!view - Documentation](/docs/#readme)
License
Released under MIT by @MichaelCurrin.
- You can freely modify and reuse.
- The original license must be included with copies of this software.
- Please link back to this repo if you use a significant portion the source code.