ENH: Support both .md and .rst

[ci skip]

Author: jcfr

Docs/conf.py

@@ -19,6 +19,9 @@
 #
 import os
 # import sys
+
+from recommonmark.parser import CommonMarkParser
+
 # sys.path.insert(0, os.path.abspath('.'))
 
 
@@ -36,11 +39,15 @@
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
+source_parsers = {
+    '.md': CommonMarkParser,
+}
+
 # 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_suffix = '.rst'
 
 # The master toctree document.
 master_doc = 'index'

requirements-docs.txt

@@ -1,5 +1,6 @@
 docutils
 pygments
+recommonmark
 sphinx
 sphinx-issues
 sphinx_rtd_theme