diff --git a/.github/macros-badge.sh b/.github/macros-badge.sh
new file mode 100644
index 0000000000..b3fbdb1c60
--- /dev/null
+++ b/.github/macros-badge.sh
@@ -0,0 +1,5 @@
+#!/bin/sh
+
+scriptdir=$(dirname $(readlink -f $0))
+
+curl "https://img.shields.io/badge/macros-$($scriptdir/../cmd/carapace/carapace --macros | wc -l)-orange"
diff --git a/.github/workflows/go.yml b/.github/workflows/go.yml
index 8cc73bfbce..3213021136 100644
--- a/.github/workflows/go.yml
+++ b/.github/workflows/go.yml
@@ -80,6 +80,7 @@ jobs:
             sh .github/macros.sh > docs/src/specs/macros.md
             mdbook build docs
             sh .github/badge.sh > docs/book/badge.svg
+            sh .github/macros-badge.sh > docs/book/macros-badge.svg
 
       - name: "push gh-pages"
         if: github.ref == 'refs/heads/master'
diff --git a/README.md b/README.md
index 9f3738b39f..6bbe4f6b3f 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,7 @@
 [![GoReportCard](https://goreportcard.com/badge/github.com/rsteube/carapace-bin)](https://goreportcard.com/report/github.com/rsteube/carapace-bin)
 [![documentation](https://img.shields.io/badge/‌-documentation-blue?logo=gitbook)](https://rsteube.github.io/carapace-bin/)
 [![Completers](https://rsteube.github.io/carapace-bin/badge.svg)](https://rsteube.github.io/carapace-bin/completers.html)
+[![Macros](https://rsteube.github.io/carapace-bin/macros-badge.svg)](https://rsteube.github.io/carapace-bin/specs/macros.html)
 
 Carapace-bin provides argument completions for many CLI commands: [see the full list here](https://rsteube.github.io/carapace-bin/completers.html), and works across many POSIX and non-POSIX shells.
 This multi-shell multi-command argument completer is based on [rsteube/carapace](https://github.com/rsteube/carapace).