diff --git a/docs.it4i/salomon/software/intel-suite/intel-parallel-studio-introduction.md b/docs.it4i/salomon/software/intel-suite/intel-parallel-studio-introduction.md
index 219ebaa772b5ea1d0963515647adc3c68e26ff83..4b1c9308957a43fafafb8f5c1280c11ba2bf81a1 100644
--- a/docs.it4i/salomon/software/intel-suite/intel-parallel-studio-introduction.md
+++ b/docs.it4i/salomon/software/intel-suite/intel-parallel-studio-introduction.md
@@ -3,6 +3,7 @@
 The Salomon cluster provides following elements of the Intel Parallel Studio XE
 
 Intel Parallel Studio XE
+
 * Intel Compilers
 * Intel Debugger
 * Intel MKL Library
diff --git a/docs.it4i/salomon/software/intel-xeon-phi.md b/docs.it4i/salomon/software/intel-xeon-phi.md
index b791f0f7cfa90ee2a4e35289f4ea05d1a3592443..634cb913c30f56f10b3a6d864d9d28e16f50deee 100644
--- a/docs.it4i/salomon/software/intel-xeon-phi.md
+++ b/docs.it4i/salomon/software/intel-xeon-phi.md
@@ -631,7 +631,7 @@ The output should be similar to:
 There are two ways how to execute an MPI code on a single coprocessor: 1.) lunch the program using "**mpirun**" from the
 coprocessor; or 2.) lunch the task using "**mpiexec.hydra**" from a host.
 
-**Execution on coprocessor**
+#### Execution on coprocessor
 
 Similarly to execution of OpenMP programs in native mode, since the environmental module are not supported on MIC, user has to setup paths to Intel MPI libraries and binaries manually. One time setup can be done by creating a "**.profile**" file in user's home directory. This file sets up the environment on the MIC automatically once user access to the accelerator through the SSH.
 
@@ -650,8 +650,8 @@ Similarly to execution of OpenMP programs in native mode, since the environmenta
 ```
 
 !!! note
-    - this file sets up both environmental variable for both MPI and OpenMP libraries.
-    - this file sets up the paths to a particular version of Intel MPI library and particular version of an Intel compiler. These versions have to match with loaded modules.
+    \* this file sets up both environmental variable for both MPI and OpenMP libraries.
+    \* this file sets up the paths to a particular version of Intel MPI library and particular version of an Intel compiler. These versions have to match with loaded modules.
 
 To access a MIC accelerator located on a node that user is currently connected to, use:
 
@@ -680,7 +680,7 @@ The output should be similar to:
     Hello world from process 0 of 4 on host cn207-mic0
 ```
 
-**Execution on host**
+#### Execution on host
 
 If the MPI program is launched from host instead of the coprocessor, the environmental variables are not set using the ".profile" file. Therefore user has to specify library paths from the command line when calling "mpiexec".
 
@@ -703,8 +703,8 @@ or using mpirun
 ```
 
 !!! note
-    - the full path to the binary has to specified (here: "**>~/mpi-test-mic**")
-    - the LD_LIBRARY_PATH has to match with Intel MPI module used to compile the MPI code
+    \* the full path to the binary has to specified (here: "**>~/mpi-test-mic**")
+    \* the LD_LIBRARY_PATH has to match with Intel MPI module used to compile the MPI code
 
 The output should be again similar to:
 
@@ -725,7 +725,7 @@ A simple test to see if the file is present is to execute:
       /bin/pmi_proxy
 ```
 
-**Execution on host - MPI processes distributed over multiple accelerators on multiple nodes**
+#### Execution on host - MPI processes distributed over multiple accelerators on multiple nodes
 
 To get access to multiple nodes with MIC accelerator, user has to use PBS to allocate the resources. To start interactive session, that allocates 2 compute nodes = 2 MIC accelerators run qsub command with following parameters:
 
@@ -885,7 +885,7 @@ A possible output of the MPI "hello-world" example executed on two hosts and two
 !!! note
     At this point the MPI communication between MIC accelerators on different nodes uses 1Gb Ethernet only.
 
-**Using the PBS automatically generated node-files**
+#### Using the PBS automatically generated node-files
 
 PBS also generates a set of node-files that can be used instead of manually creating a new one every time. Three node-files are genereated:
 
diff --git a/docs.it4i/salomon/software/java.md b/docs.it4i/salomon/software/java.md
index f607960cd793a6a84315cf11651416157d6bd015..703e53fc1093cf28aeb5c80b985174784e54ad90 100644
--- a/docs.it4i/salomon/software/java.md
+++ b/docs.it4i/salomon/software/java.md
@@ -1,7 +1,5 @@
 # Java
 
-**Java on the cluster**
-
 Java is available on the cluster. Activate java by loading the Java module
 
 ```bash
diff --git a/docs.it4i/salomon/software/numerical-languages/r.md b/docs.it4i/salomon/software/numerical-languages/r.md
index a8829cb43e48f3d91cd82d312f98a0a5e0687c9f..e6f9a69b4d27fd0b4b844703759b7dc15d109d8c 100644
--- a/docs.it4i/salomon/software/numerical-languages/r.md
+++ b/docs.it4i/salomon/software/numerical-languages/r.md
@@ -14,7 +14,7 @@ Read more on <http://www.r-project.org/>, <http://cran.r-project.org/doc/manuals
 
 ## Modules
 
-**The R version 3.1.1 is available on the cluster, along with GUI interface Rstudio**
+The R version 3.1.1 is available on the cluster, along with GUI interface Rstudio
 
 | Application | Version           | module              |
 | ----------- | ----------------- | ------------------- |
@@ -347,7 +347,7 @@ mpi.apply Rmpi example:
     mpi.quit()
 ```
 
-The above is the mpi.apply MPI example for calculating the number π. Only the slave processes carry out the calculation. Note the **mpi.parSapply(), ** function call. The package parallel [example](r/#package-parallel)[above](r/#package-parallel) may be trivially adapted (for much better performance) to this structure using the mclapply() in place of mpi.parSapply().
+The above is the mpi.apply MPI example for calculating the number π. Only the slave processes carry out the calculation. Note the **mpi.parSapply()**, function call. The package parallel [example](r/#package-parallel) [above](r/#package-parallel) may be trivially adapted (for much better performance) to this structure using the mclapply() in place of mpi.parSapply().
 
 Execute the example as: