diff --git a/README.md b/README.md
index 4ca1c01..02a2928 100644
--- a/README.md
+++ b/README.md
@@ -33,8 +33,8 @@ The only requirements are (if memory serves) numpy and scipy.
 
 At some point, pointers to a library of emulators of popular vegetation and atmospheric RT codes will be provided.
 
-Citation
---------
+### Citation
+
 
 If you use this code, we would be grateful if you cited the following paper:
 
diff --git a/setup.py b/setup.py
index 4b68eef..0a94dee 100644
--- a/setup.py
+++ b/setup.py
@@ -3,6 +3,12 @@
 from distutils.core import setup
 from distutils.core import setup, Extension
 
+
+from os import path
+this_directory = path.abspath(path.dirname(__file__))
+with open(path.join(this_directory, 'README.md'), encoding='utf-8') as f:
+    long_description = f.read()
+
 setup(name='gp_emulator',
       version='1.6.1',
       description='A Python GaussianProcess emulator software package',
@@ -18,6 +24,8 @@
         'Intended Audience :: Developers',
         'Environment :: Console'],
       author='J Gomez-Dans',
+      long_description=long_description,
+      long_description_content_type='text/markdown',
       author_email='j.gomez-dans@ucl.ac.uk',
       url='http://github.com/jgomezdans/gp_emulator',
       packages=['gp_emulator'],