diff --git a/README.md b/README.md
index 5e9dfec62c55ee1488e516038e25904955da0933..6748dc191c23c156265e470300322183d873ac7d 100644
--- a/README.md
+++ b/README.md
@@ -3,8 +3,7 @@ Coverage: ![alt text](coverage.svg)
 Based on a original work by Jeff Andrews (can be found in old_solution/ directory)
 updated and extended for Python3 by Robert Izzard, David hendriks
 
-Requirements
----------------------
+## Requirements
 To run this code you need to at least have installations of:
 - Python3
 - binary_c version 2.1+
@@ -18,8 +17,7 @@ And the following python packages (which will get installed automatically when i
 - astropy
 - matplotlib
 
-Environment variables
----------------------
+## Environment variables
 Before compilation you need to have certain environment variables:
 
 Required:
@@ -27,20 +25,17 @@ Required:
 - `LD_LIBRARY_PATH` should include $BINARY_C/src and whatever directories are required to run binary_c (e.g. locations of libgsl, libmemoize, librinterpolate, etc.)
 - `LIBRARY_PATH` should include whatever directories are required to build binary_c (e.g. locations of libgsl, libmemoize, librinterpolate, etc.)
 
-Build instructions
-------------------
+## Build instructions
 First, make sure you have built binary_c (See `$BINARY_C/doc/binary_c2.pdf` section: installation for all the installation instructions for `binary_c`)) and that it functions correctly. 
 
-Installation via PIP:
-=====================
+### Installation via PIP:
 To install this package via pip:
 
 ```
 pip install binarycpython
 ```
 
-Installation from source:
-=========================
+### Installation from source:
 For this it is best to set up a virtual environment for this. Activate the virtualenvironment and enter the downloaded version of the repo. 
 
 Then run
@@ -50,20 +45,16 @@ python setup.py clean && python setup.py build --force && python setup.py sdist
 
 This will install this package into the virtual environment. Making changes to the sourcecode can be "installed" into the virtual env with the same command. 
 
-Examples
---------
+## Examples
 See the examples/ directory for example script. The documentation contains example pages as well. 
 
-Usage notes
------------
+## Usage notes
 Make sure that with every change/recompilation you make in `binary_c`, you also rebuild this package. 
 
-Documentation
--------------
+## Documentation
 Look in the doc/ directory. Within the build/html/ there is the html version of the documentation. 
 
-FAQ/Issues:
---------------------
+## FAQ/Issues:
 Building issues with binary_c itself: 
 - see the documentation of binary_c (in doc/). 
 - If you have MESA installed, make sure that the `$MESASDK_ROOT/bin/mesasdk_init.sh` is not sourced. It comes with its own version of some programs, and those can interfere with installing.