diff --git a/scripts/generate_mkdocs.py b/scripts/generate_mkdocs.py
index 612e3e35232dc..8a38f8c173399 100644
--- a/scripts/generate_mkdocs.py
+++ b/scripts/generate_mkdocs.py
@@ -157,7 +157,8 @@ def generate_rule_metadata(rule_doc: Path) -> None:
             "\n".join(
                 [
                     "---",
-                    f"description: {description}",
+                    "description: |-",
+                    f"  {description}",
                     "tags:",
                     f"- {rule_code}",
                     "---",