FIX: Actually use markdown for documentation generation

src/doc/conf.py

@@ -52,7 +52,11 @@ templates_path = ['_templates']
 # You can specify multiple suffix as a list of string:
 #
 # source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
+
 
 # The master toctree document.
 master_doc = 'index'