diff --git a/setup.py b/setup.py
index 47df7d61..9b608ab1 100644
--- a/setup.py
+++ b/setup.py
@@ -3,11 +3,18 @@
 import versioneer
 
 
+desc = "Controls for using diffractometers within the Bluesky Framework"
+desc += ": https://blueskyproject.io"
+with open("README.md", "r") as f:
+    long_desc = f.read()
+
 setup(
     name="hklpy",
     version=versioneer.get_version(),
     cmdclass=versioneer.get_cmdclass(),
-    description="Controls for using diffractometers within the Bluesky Framework: https://blueskyproject.io",
+    description=desc,
+    long_description=long_desc,
+    long_description_content_type="text/markdown",
     maintainer="prjemian",
     maintainer_email="prjemian+hklpy@gmail.com",
     url="https://github.com/bluesky/hklpy",