diff --git a/docs/conf.py b/docs/conf.py
index 67ec925761..9d40a08f53 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -15,6 +15,9 @@
 import sys
 import os
 
+from recommonmark.parser import CommonMarkParser
+source_parsers = {'.md': CommonMarkParser}
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.