diff --git a/.markdownlint.yaml b/.markdownlint.yaml
new file mode 100644
index 00000000..d877b77a
--- /dev/null
+++ b/.markdownlint.yaml
@@ -0,0 +1,6 @@
+---
+default: true
+MD013:
+  line_length: 500
+MD024:
+  siblings_only: true  # heading duplication is allowed for non-sibling headings (common in changelogs)