diff --git a/examples/1ptracer/README.md b/examples/1ptracer/README.md
index fc90a054fbbea31ce99babccdf19bee3a72897c2..0ebe64e72ab4c2ae695fa91d90062ff0fa245883 100644
--- a/examples/1ptracer/README.md
+++ b/examples/1ptracer/README.md
@@ -8,10 +8,15 @@ is obtained from the solution of a stationary single-phase problem, and subseque
 this velocity field is used for the simulation of the transport of tracer through the
 domain.
 
-The main points illustrated in this example are:
-* Setting up and solving a stationary single-phase flow problem
-* Setting up and solving a tracer transport problem
-* Solving two problems sequentially and realizing the data transfer
+__The main points illustrated in this example are__
+* setting up and solving a stationary single-phase flow problem
+* setting up and solving a tracer transport problem
+* solving two problems sequentially and realizing the data transfer
+* using a simple method to generate a random permeability field
+
+__Table of contents__. This description is structured as follows:
+
+[[_TOC_]]
 
 ## Problem set-up
 A domain with an extent of $`10 \, \mathrm{m} \times 10 \, \mathrm{m}`$ is considered,
diff --git a/examples/1ptracer/doc/intro.md b/examples/1ptracer/doc/intro.md
index ae567177150477a68795a4ae426816a3069b1022..83583192b21dc6f7667f7a1d3e5bf2345630d8f4 100644
--- a/examples/1ptracer/doc/intro.md
+++ b/examples/1ptracer/doc/intro.md
@@ -6,10 +6,15 @@ is obtained from the solution of a stationary single-phase problem, and subseque
 this velocity field is used for the simulation of the transport of tracer through the
 domain.
 
-The main points illustrated in this example are:
-* Setting up and solving a stationary single-phase flow problem
-* Setting up and solving a tracer transport problem
-* Solving two problems sequentially and realizing the data transfer
+__The main points illustrated in this example are__
+* setting up and solving a stationary single-phase flow problem
+* setting up and solving a tracer transport problem
+* solving two problems sequentially and realizing the data transfer
+* using a simple method to generate a random permeability field
+
+__Table of contents__. This description is structured as follows:
+
+[[_TOC_]]
 
 ## Problem set-up
 A domain with an extent of $`10 \, \mathrm{m} \times 10 \, \mathrm{m}`$ is considered,