diff --git a/docs/requirements.txt b/docs/requirements.txt
index 9c409bc241..91cd59da01 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,9 +1,10 @@
-## The following requirements were added by pip freeze:
 alabaster==0.7.8
 Babel==2.3.4
 certifi==2018.4.16
 chardet==3.0.4
+CommonMark==0.5.5
 docutils==0.12
+future==0.16.0
 idna==2.6
 imagesize==0.7.1
 Jinja2==2.8
@@ -14,9 +15,10 @@ Pillow==5.1.0
 Pygments==2.2.0
 pyparsing==2.2.0
 pytz==2016.4
+recommonmark==0.4.0
 reportlab==3.4.0
 requests==2.18.4
-rst2pdf==0.93
+rst2pdf==0.93.dev0
 six==1.10.0
 snowballstemmer==1.2.1
 Sphinx==1.7.4
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 5684a4962e..e24dd0efca 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -41,8 +41,10 @@ templates_path = ['_templates']
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
-# source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
+source_parsers = {
+    '.md': 'recommonmark.parser.CommonMarkParser',
+}
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'