diff --git a/setup.py b/setup.py
index 50058b5..aa0cded 100644
--- a/setup.py
+++ b/setup.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python
+import os
 import unittest
 
 from setuptools import setup
@@ -6,6 +7,10 @@ from setuptools import setup
 with open('pubs/version.py') as f:
     exec(f.read())  # defines __version__
 
+here = os.path.abspath(os.path.dirname(__file__))
+with open(os.path.join(here, 'readme.md'), 'r') as fd:
+    long_description = fd.read()
+
 def pubs_test_suite():
     test_loader = unittest.TestLoader()
     test_suite = test_loader.discover('tests', pattern='test_*.py')
@@ -20,6 +25,9 @@ setup(
     url='https://github.com/pubs/pubs',
 
     description='command-line scientific bibliography manager',
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+
     packages=['pubs',
               'pubs.config',
               'pubs.commands',