diff --git a/compose/compose-file.md b/compose/compose-file.md
index 40dbfda3b5..7b38d8700c 100644
--- a/compose/compose-file.md
+++ b/compose/compose-file.md
@@ -70,8 +70,8 @@ This will result in an image named `webapp` and tagged `tag`, built from `./dir`
 > **Note**: In the [version 1 file format](compose-file.md#version-1), `build` is different in
 > two ways:
 >
-> -   Only the string form (`build: .`) is allowed - not the object form.
-> -   Using `build` together with `image` is not allowed. Attempting to do so
+> 1.   Only the string form (`build: .`) is allowed - not the object form.
+> 2.   Using `build` together with `image` is not allowed. Attempting to do so
 >     results in an error.
 
 #### context
@@ -103,13 +103,15 @@ specified.
 
 > **Note**: In the [version 1 file format](compose-file.md#version-1), `dockerfile` is
 > different in two ways:
-
-  * It appears alongside `build`, not as a sub-option:
-
-        build: .
-        dockerfile: Dockerfile-alternate
-
-  * Using `dockerfile` together with `image` is not allowed. Attempting to do so results in an error.
+>
+>  1.  It appears alongside `build`, not as a sub-option:
+>
+>      ```
+>      build: .
+>      dockerfile: Dockerfile-alternate
+>      ```
+>
+>  2.  Using `dockerfile` together with `image` is not allowed. Attempting to do so results in an error.
 
 #### args
 
diff --git a/css/documentation.css b/css/documentation.css
index 33524135b3..2fdab54e80 100644
--- a/css/documentation.css
+++ b/css/documentation.css
@@ -16,10 +16,15 @@
     font-size: 16px;
     border-left: 4px solid #6db9d1;
     padding: 6px;
-    background-color: #f5f5f5;
+    background-color: #fafafa;
+    color: black !important;
+}
+#DocumentationText blockquote li div.highlighter-rouge {
+  padding-left: 20px;
+  padding-right: 20px;
 }
 #DocumentationText blockquote p {
-    color: black;
+    color: black !important;
 		margin: 0;
 		padding: 10px 20px;
 }
@@ -27,6 +32,9 @@
     color: #6db9d1;
     /* most Note's have a non-strong ':' display: block;*/
 }
+#DocumentationText blockquote ol, #DocumentationText blockquote ul {
+  padding-left: 20px !important;
+}
 #DocumentationText code {
   border-width: 0px !important;
   background-color: #f5f5f5 !important;