diff --git a/README.md b/README.md
index d254f036ce0756546b261baaf0a4c8872aab7fdf..d8e3fd7e5ab5798ae7d3da3396c84c49967fc376 100755
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-\brief bayesianem, an IMP module for Bayesian multi-scale modeling of macromolecular structures based on cryo-electron microscopy density maps
+# bayesianem, an IMP module for Bayesian multi-scale modeling of macromolecular structures based on cryo-electron microscopy density maps
 
-# Usage:
+## Usage:
 
 First, import the module:
 
@@ -30,7 +30,7 @@ gem.set_label("Total")
 output_objects.append(gem)
 ```
 
-# Info
+## Info
 
 _Author(s)_: Samuel Hanot, Massimiliano Bonomi, Riccardo Pellarin