diff --git a/doc_src/cmds/if.rst b/doc_src/cmds/if.rst
index 6e2e178b4..0fd9defb3 100644
--- a/doc_src/cmds/if.rst
+++ b/doc_src/cmds/if.rst
@@ -6,12 +6,10 @@ if - conditionally execute a command
 Synopsis
 --------
 
-::
-
-    if CONDITION; COMMANDS_TRUE...;
-    [else if CONDITION2; COMMANDS_TRUE2...;]
-    [else; COMMANDS_FALSE...;]
-    end
+| **if** *CONDITION*; *COMMANDS_TRUE*...;
+| [**else** **if** *CONDITION2*; *COMMANDS_TRUE2*...;]
+| [**else**; *COMMANDS_FALSE*...;]
+| **end**
 
 Description
 -----------
diff --git a/doc_src/cmds/isatty.rst b/doc_src/cmds/isatty.rst
index 5ad6b2267..cbd52bb2e 100644
--- a/doc_src/cmds/isatty.rst
+++ b/doc_src/cmds/isatty.rst
@@ -6,9 +6,7 @@ isatty - test if a file descriptor is a terminal
 Synopsis
 --------
 
-::
-
-    isatty [FILE DESCRIPTOR]
+``isatty`` [*FILE DESCRIPTOR*]
 
 Description
 -----------
@@ -23,11 +21,7 @@ If the specified file descriptor is a terminal device, the exit status of the co
 Examples
 --------
 
-From an interactive shell, the commands below exit with a return value of zero:
-
-
-
-::
+From an interactive shell, the commands below exit with a return value of zero::
 
     isatty
     isatty stdout
@@ -35,11 +29,7 @@ From an interactive shell, the commands below exit with a return value of zero:
     echo | isatty 1
 
 
-And these will exit non-zero:
-
-
-
-::
+And these will exit non-zero::
 
     echo | isatty
     isatty 9
diff --git a/doc_src/cmds/jobs.rst b/doc_src/cmds/jobs.rst
index 899a9e80b..db4ebad76 100644
--- a/doc_src/cmds/jobs.rst
+++ b/doc_src/cmds/jobs.rst
@@ -6,9 +6,7 @@ jobs - print currently running jobs
 Synopsis
 --------
 
-::
-
-    jobs [OPTIONS] [ PID | %JOBID ]
+``jobs`` [*OPTIONS*] [ *PID* | %*JOBID* ]
 
 
 Description
diff --git a/doc_src/cmds/math.rst b/doc_src/cmds/math.rst
index 87ef44c30..4efebe831 100644
--- a/doc_src/cmds/math.rst
+++ b/doc_src/cmds/math.rst
@@ -6,9 +6,7 @@ math - perform mathematics calculations
 Synopsis
 --------
 
-::
-
-    math [-sN | --scale=N] [-bBASE | --base=BASE] [--] EXPRESSION
+``math`` [**-s** | **--scale** *N*] [**-b** | **--base** *BASE*] [--] *EXPRESSION...*
 
 
 Description
diff --git a/doc_src/cmds/set_color.rst b/doc_src/cmds/set_color.rst
index aeac662e5..15ba0f0fd 100644
--- a/doc_src/cmds/set_color.rst
+++ b/doc_src/cmds/set_color.rst
@@ -6,7 +6,7 @@ set_color - set the terminal color
 Synopsis
 --------
 
-``set_color`` [*options*] *VALUE*
+``set_color`` [*OPTIONS*] *VALUE*
 
 Description
 -----------
@@ -24,7 +24,7 @@ An RGB value with three or six hex digits, such as A0FF33 or f2f can be used. ``
 
 A second color may be given as a desired fallback color. e.g. ``set_color 124212 brblue`` will instruct set_color to use *brblue* if a terminal is not capable of the exact shade of grey desired. This is very useful when an 8 or 16 color terminal might otherwise not use a color.
 
-The following options are available:
+The following *OPTIONS* are available:
 
 - ``-b``, ``--background`` *COLOR* sets the background color.
 - ``-c``, ``--print-colors`` prints a list of the 16 named colors.