diff --git a/docs/clean_md.py b/docs/clean_md.py
index 2af0e8ae..fd5656dd 100755
--- a/docs/clean_md.py
+++ b/docs/clean_md.py
@@ -59,6 +59,8 @@ def clean_markdown_content(content, start_patterns, any_patterns, api_ref=False)
                 line = f"{line}`"
 
         line = line.replace("<br/>", "")
+        line = line.replace("\n* **", "\n\n* **")
+        line = line.replace("**\n  : ", "**\n    ")
 
         result.append(line)