diff --git a/docsite/rst/YAMLSyntax.rst b/docsite/rst/YAMLSyntax.rst
index b8d19099eb3..c5d94e50ff0 100644
--- a/docsite/rst/YAMLSyntax.rst
+++ b/docsite/rst/YAMLSyntax.rst
@@ -42,7 +42,7 @@ A dictionary is represented in a simple ``key: value`` form (the colon must be f
         job: Developer
         skill: Elite
 
-More complicated data structures are possible, such as lists of dictionaries, or dictionaries whose values are lists.  Or a mix of both::
+More complicated data structures are possible, such as lists of dictionaries, dictionaries whose values are lists or a mix of both::
 
     # Employee records
     -  martin:
@@ -77,7 +77,7 @@ Ansible doesn't really use these too much, but you can also specify a boolean va
     likes_emacs: TRUE
     uses_cvs: false
 
-Values can span multiple lines using *|* or *>*.  Spanning multiple lines using a *|* will include the newlines.  Using a *>* will ignore newlines; it's used to make what would otherwise be a very long line easier to read and edit.
+Values can span multiple lines using `|` or `>`.  Spanning multiple lines using a `|` will include the newlines.  Using a `>` will ignore newlines; it's used to make what would otherwise be a very long line easier to read and edit.
 In either case the indentation will be ignored.
 Examples are::