diff --git a/docs/contributions.rst b/docs/contributions.rst
index 0d84ac2537..92b37782d7 100644
--- a/docs/contributions.rst
+++ b/docs/contributions.rst
@@ -316,9 +316,9 @@ You can write a parser with regex patterns.
 a parser written in regex patterns into C source code.
 
 The `man` parser is one example described in regex patterns.
-See the output of the following command line for details:
+See the output of the following command line for details::
 
-	`git show  0a9e78a8a40e8595b3899e2ad249c8f2c3819c8a^..89aa548`
+	git show 0a9e78a8a40e8595b3899e2ad249c8f2c3819c8a^..89aa548
 
 Translated C code is also committed to our git repository. The
 translated code is useful for building ctags on the platforms where
diff --git a/docs/man/ctags.1.rst b/docs/man/ctags.1.rst
index 6dfc713384..d4197c2d2c 100644
--- a/docs/man/ctags.1.rst
+++ b/docs/man/ctags.1.rst
@@ -1414,7 +1414,7 @@ imbalance results from following a #if conditional branch.
 
 ctags will also try to specially handle arguments lists
 enclosed in double sets of parentheses in order to accept the following
-conditional construct:
+conditional construct::
 
 	extern void foo __ARGS((int one, char two));
 
diff --git a/docs/optlib.rst b/docs/optlib.rst
index 184f874b3e..6838038de1 100644
--- a/docs/optlib.rst
+++ b/docs/optlib.rst
@@ -31,7 +31,7 @@ passed through command line.
 
 The following file is an example of an option file:
 
-.. code-block:: python
+.. code-block::
 
 	# Exclude directories that don't contain real code
 	--exclude=Units
@@ -44,9 +44,9 @@ Whitespaces at the start of lines are ignored during loading.
 
 And it works exactly as if we had called:
 
-```sh
-ctags --exclude=Units --exclude=tinst-root --exclude=Tmain
-```
+.. code-block:: sh
+
+	ctags --exclude=Units --exclude=tinst-root --exclude=Tmain
 
 There are two categories of option files, though they both contain command
 line options: **preload** and **optlib** option files.
diff --git a/man/ctags.1.rst.in b/man/ctags.1.rst.in
index 67ab879565..2670a88310 100644
--- a/man/ctags.1.rst.in
+++ b/man/ctags.1.rst.in
@@ -1414,7 +1414,7 @@ imbalance results from following a #if conditional branch.
 
 @CTAGS_NAME_EXECUTABLE@ will also try to specially handle arguments lists
 enclosed in double sets of parentheses in order to accept the following
-conditional construct:
+conditional construct::
 
 	extern void foo __ARGS((int one, char two));