Enable using markdown for Sphinx docs (#401)

Author: WasabiFan

docs/conf.py

@@ -25,8 +25,10 @@
 if on_rtd:
     import pip
     pip.main(['install', 'sphinx_bootstrap_theme'])
+    pip.main(['install', 'recommonmark'])
 
 import sphinx_bootstrap_theme
+from recommonmark.parser import 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
@@ -49,10 +51,14 @@
 # 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']
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'