diff --git a/clang-tools-extra/docs/ModularizeUsage.rst b/clang-tools-extra/docs/ModularizeUsage.rst
index 5b20c1c8ad0c..64c89ed50bcb 100644
--- a/clang-tools-extra/docs/ModularizeUsage.rst
+++ b/clang-tools-extra/docs/ModularizeUsage.rst
@@ -1,6 +1,6 @@
-=====================
+================
 modularize Usage
-=====================
+================
 
 ``modularize [<modularize-options>] <include-files-list> [<front-end-options>...]``
 
@@ -14,11 +14,11 @@ with respect to each other. Lines beginning with '#' and empty
 lines are ignored. Header file names followed by a colon and
 other space-separated file names will include those extra files
 as dependencies. The file names can be relative or full paths,
-but must be on the same line. For example:
+but must be on the same line. For example::
 
-  | header1.h
-  | header2.h
-  | header3.h: header1.h header2.h
+  header1.h
+  header2.h
+  header3.h: header1.h header2.h
 
 Note that unless a "-prefix (header path)" option is specified,
 non-absolute file paths in the header list file will be relative
@@ -32,7 +32,7 @@ contain C source, so you might need to specify the ``-x c++`` Clang option
 to tell Clang that the header contains C++ definitions.
 
 Modularize Command Line Options
-============================
+===============================
 
 .. option:: -prefix <header-path>