--- title: "awesome-github-badges vs github-markdown-toc" type: "comparison" canonical_url: "https://www.graphcanon.com/compare/chetanraj-awesome-github-badges-vs-ekalinin-github-markdown-toc" tools: ["chetanraj-awesome-github-badges", "ekalinin-github-markdown-toc"] --- # awesome-github-badges vs github-markdown-toc *GraphCanon updated Aug 1, 2026* ## Verdict Pick awesome-github-badges if curated badge list for enhancing GitHub README.md files; pick github-markdown-toc if github-markdown-toc is a shell-based tool to create table of contents for Markdown files on GitHub without requiring additional software installation. [awesome-github-badges](https://github.com/chetanraj/awesome-github-badges) reports 162 GitHub stars, 59 forks, and 1 open issues, last pushed Apr 26, 2026. [github-markdown-toc](https://github.com/ekalinin/github-markdown-toc) has 3.3k stars, 2.7k forks, and 24 open issues, last pushed Oct 12, 2024. Figures are from public GitHub metadata via [awesome-github-badges's repository](https://github.com/chetanraj/awesome-github-badges) and [github-markdown-toc's repository](https://github.com/ekalinin/github-markdown-toc). | | [awesome-github-badges](/tools/chetanraj-awesome-github-badges.md) | [github-markdown-toc](/tools/ekalinin-github-markdown-toc.md) | | --- | --- | --- | | Tagline | A curated list of awesome github README.md badges | Tool for generating Table of Contents for Markdown files | | Stars | 162 | 3,294 | | Forks | 59 | 2,686 | | Open issues | 1 | 24 | | Language | - | Shell | | Adopt for | Curated badge list for enhancing GitHub README.md files | github-markdown-toc is a shell-based tool to create table of contents for Markdown files on GitHub without requiring additional software installation. | | Persona | - | - | | Runtime | - | - | | License | CC0-1.0 | MIT | | Categories | Developer Tools | Developer Tools | ## Trust and health _Sourced signals - not a safety guarantee. No winner column._ | | [awesome-github-badges](/tools/chetanraj-awesome-github-badges.md) | [github-markdown-toc](/tools/ekalinin-github-markdown-toc.md) | | --- | --- | --- | | Maintenance | Slowing (36%) | Dormant (18%) | | Days since push | 96d | 657d | | Open issues (now) | 1 | 24 | | Full report | [trust report](/tools/chetanraj-awesome-github-badges/trust.md) | [trust report](/tools/ekalinin-github-markdown-toc/trust.md) | ## Decision facts: awesome-github-badges - **Adopt for:** Curated badge list for enhancing GitHub README.md files ## Decision facts: github-markdown-toc - **Adopt for:** github-markdown-toc is a shell-based tool to create table of contents for Markdown files on GitHub without requiring additional software installation. ## Choose when ### Choose awesome-github-badges if… - License: awesome-github-badges is CC0-1.0, github-markdown-toc is MIT. - Tags unique to awesome-github-badges: awesome, awesome-list, badge, github-badge. - When you need a wide variety of badges to illustrate build statuses, dependency updates, and code quality directly in your README.md file. ### Choose github-markdown-toc if… - License: github-markdown-toc is MIT, awesome-github-badges is CC0-1.0. - Tags unique to github-markdown-toc: github, markdown, shell, table-of-contents. - github-markdown-toc ships Docker support for self-hosted deployment. - For users looking to generate a TOC from local or remote Markdown files, including README.md and wiki pages, in environments where installing software is either not allowed or unnecessary. ## When NOT to use awesome-github-badges - Avoid if primarily interested in badge generation services; awesome-github-badges does not produce the badges itself, merely lists them. - Not suitable for users needing real-time dynamic data embedding as it is a curated list rather than an active badge generation service. ## When NOT to use github-markdown-toc - In Windows environments since it relies on shell scripting, although a Go-based alternative exists for more reliable cross-platform use. - For projects requiring advanced features such as parallel processing, which are supported by competitors written in languages better suited for these tasks. ## Common questions ### What is the difference between awesome-github-badges and github-markdown-toc? awesome-github-badges: A curated list of awesome github README.md badges. github-markdown-toc: Tool for generating Table of Contents for Markdown files. See the comparison table for live GitHub stats and shared categories. ### When should I choose awesome-github-badges over github-markdown-toc? Choose awesome-github-badges over github-markdown-toc when License: awesome-github-badges is CC0-1.0, github-markdown-toc is MIT; Tags unique to awesome-github-badges: awesome, awesome-list, badge, github-badge; When you need a wide variety of badges to illustrate build statuses, dependency updates, and code quality directly in your README.md file. ### When should I choose github-markdown-toc over awesome-github-badges? Choose github-markdown-toc over awesome-github-badges when License: github-markdown-toc is MIT, awesome-github-badges is CC0-1.0; Tags unique to github-markdown-toc: github, markdown, shell, table-of-contents; github-markdown-toc ships Docker support for self-hosted deployment; For users looking to generate a TOC from local or remote Markdown files, including README.md and wiki pages, in environments where installing software is either not allowed or unnecessary. ### When should I avoid awesome-github-badges? Avoid if primarily interested in badge generation services; awesome-github-badges does not produce the badges itself, merely lists them. Not suitable for users needing real-time dynamic data embedding as it is a curated list rather than an active badge generation service. ### When should I avoid github-markdown-toc? In Windows environments since it relies on shell scripting, although a Go-based alternative exists for more reliable cross-platform use. For projects requiring advanced features such as parallel processing, which are supported by competitors written in languages better suited for these tasks. ### Is awesome-github-badges or github-markdown-toc more popular on GitHub? github-markdown-toc has more GitHub stars (3,294 vs 162). Stars measure visibility, not whether either tool fits your constraints. ### Are awesome-github-badges and github-markdown-toc open source? Yes - both are open-source projects on GitHub (awesome-github-badges: CC0-1.0, github-markdown-toc: MIT). ### Where can I find alternatives to awesome-github-badges or github-markdown-toc? GraphCanon lists graph-backed alternatives at [awesome-github-badges alternatives](/tools/chetanraj-awesome-github-badges/alternatives) and [github-markdown-toc alternatives](/tools/ekalinin-github-markdown-toc/alternatives) ([awesome-github-badges markdown twin](/tools/chetanraj-awesome-github-badges/alternatives.md), [github-markdown-toc markdown twin](/tools/ekalinin-github-markdown-toc/alternatives.md)), ranked by typed relationship edges rather than popularity votes. ### Is there a machine-readable version of this comparison? Yes. The markdown twin at [this comparison](/compare/chetanraj-awesome-github-badges-vs-ekalinin-github-markdown-toc.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers. ### Which is better maintained, awesome-github-badges or github-markdown-toc? awesome-github-badges: Slowing. github-markdown-toc: Dormant. Compare maintenance labels, days since push, and release cadence in the trust section below - stars alone do not measure maintenance. ### Where are the full trust reports for awesome-github-badges and github-markdown-toc? GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [awesome-github-badges trust report](/tools/chetanraj-awesome-github-badges/trust); [github-markdown-toc trust report](/tools/ekalinin-github-markdown-toc/trust). --- **Machine-readable endpoints** - JSON: [`/api/graphcanon/graph?tool=chetanraj-awesome-github-badges`](/api/graphcanon/graph?tool=chetanraj-awesome-github-badges) - LLM index: [/llms.txt](/llms.txt) - Full corpus: [/llms-full.txt](/llms-full.txt) _GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_