diff --git a/docs/source/_assets/less/markdown.less b/docs/source/_assets/less/markdown.less
index 21cc173b2..e28af9e68 100644
--- a/docs/source/_assets/less/markdown.less
+++ b/docs/source/_assets/less/markdown.less
@@ -13,6 +13,12 @@
     }
   }
 
+  > hr {
+    @apply .my-12;
+    @apply .border-t-0 .border-r-0 .border-l-0;
+    @apply .border-b .border-dark-softer;
+  }
+
   > a, a& {
     @apply .text-blue;
   }
@@ -58,7 +64,7 @@
   }
 
   > h3, h3& {
-    @apply .mt-16;
+    @apply .mt-12;
     @apply .mb-8;
     @apply .text-dark;
     @apply .leading-none;
@@ -68,8 +74,8 @@
 
   > p, p&, > blockquote > p {
     @apply .text-dark-soft;
-    @apply .mt-8;
-    @apply .mb-3;
+    @apply .mt-4;
+    @apply .mb-4;
     line-height: 1.75;
   }