diff --git a/README.md b/README.md
index 63ca00a..e6a756b 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
-#scLVM
+# scLVM
 
 
-##What is scLVM?
+## What is scLVM?
 
 scLVM is a modelling framework for single-cell RNA-seq data that can be used to dissect the observed heterogeneity into different sources, thereby allowing for the correction of confounding sources of variation. 
 
@@ -9,11 +9,11 @@ scLVM was primarily designed to account for cell-cycle induced variations in sin
 
 Software by Florian Buettner, Paolo Casale and Oliver Stegle. scLVM is explained in more detail in the accompanying publication [1].
 
-##Philosophy
+## Philosophy
 
 Observed heterogeneity in single-cell profiling data is multi-factorial. scLVM provides an efficient framework for unravelling this heterogeneity, correcting for confounding factors and facilitating unbiased downstream analyses. scLVM builds on Gaussian process latent variable models and linear mixed models. The underlying models are based on inference schemes implemented in [LIMIX](https://github.com/PMBio/limix).
 
-##Installation:
+## Installation:
 
 * scLVM can be installed  using ``pip install scLVM`` on most systems. If you have trouble using pip, have a look at the detailed instructions in the wiki.
  
@@ -29,7 +29,7 @@ This can either be perfromed as part of the [R package](https://github.com/PMBio
 
 * For users who prefer to run the entire scLVM pipeline in R, we also provide an R package wich is based on [rPython](http://cran.r-project.org/web/packages/rPython/index.html). The scLVM R package can be downloaded [here](https://github.com/PMBio/scLVM/tree/master/R)
 
-##How to use scLVM?
+## How to use scLVM?
 The current software version should be considered as beta. Still, the method is working and can be used to reproduce the result of the accompanying publication [1]. More extensive documentation, tutorials and examples will be available soon.
 
 A good starting point are the tutorials for our [R package](https://github.com/PMBio/scLVM/tree/master/R/tutorials) and for the [python implementation](https://github.com/PMBio/scLVM/blob/master/tutorials).
@@ -39,12 +39,12 @@ For an illustration of how scLVM can be applied to the T-cell data considered in
 While in principle both the R package and the python package have the same funcitonality, we recommend using the R package as more extensive documentation is available and the focus of development currently lies on the R package.
 
 
-##Problems ?
+## Problems ?
 
 If you want to use scLVM and encounter any issues, please contact us by email: scLVM-dev@ebi.ac.uk
 
-##License
+## License
 See [LICENSE](https://github.com/PMBio/scLVM/blob/master/license.txt)
 
-###References
+### References
 [1] Buettner F, Natarajan KN, Casale FP, Proserpio V, Scialdone A, Theis FJ, Teichmann SA, Marioni JC & Stegle O, 2015. Computational analysis of cell-to-cell heterogeneity in single-cell RNA-Sequencing data reveals hidden subpopulation of cells, Nature Biotechnology, doi: 10.1038/nbt.3102.