Badges is a curated collection of Markdown code snippets for embedding status badges in project README files.
The project solves the problem of finding and copying badge markup by maintaining a comprehensive reference organized by category. Rather than hunting through documentation for shields.io or forthebadge.com syntax, developers can browse a single repository containing ready-to-use Markdown and reStructuredText code for badges spanning generic status indicators, language-specific badges for Python, Go, Rust, and JavaScript, platform badges for PyPI and npm, GitHub repository metrics, license declarations, and decorative badges. Each badge entry includes the exact markup needed to render it.
The tool suits developers who want to quickly add professional-looking status indicators to their project documentation without learning badge service APIs. It works well for projects of any size that use GitHub or Bitbucket. The repository provides parallel reStructuredText versions alongside Markdown, making it useful for projects using Sphinx documentation. The collection includes badges from multiple sources including shields.io and forthebadge.com, giving developers options for visual style and data sources.
The project maintains an organized, categorized structure with a detailed table of contents covering dozens of badge types. Contributions are explicitly welcomed in the description, indicating openness to community additions. The repository includes a TODO section and notes on possible future additions, showing active consideration of scope and evolution. The primary language is Makefile, suggesting some automation or build process supports the repository's organization and maintenance.
