diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml
index e0ca4b419..c3a669be1 100644
--- a/.markdownlint-cli2.yaml
+++ b/.markdownlint-cli2.yaml
@@ -11,3 +11,6 @@ config:
       # https://gist.github.com/scmx/eca72d44afee0113ceb0349dd54a84a2
       - summary
       - details
+  # Allow duplicate headings. These do not cause problems for GitHub, which is
+  # our default renderer
+  MD024: false