Add markdown support

doc/conf.py

@@ -39,8 +39,8 @@
 # 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'
@@ -173,3 +173,9 @@ def setup(app):
      author, 'cloud_GC', 'One line description of project.',
      'Miscellaneous'),
 ]
+
+# -- Markdown support through recommonmark ------
+
+source_parsers = {
+   '.md': 'recommonmark.parser.CommonMarkParser',
+}

doc/index.rst

@@ -14,3 +14,4 @@ Contents
 
    motivation
    tutorial
+   test_markdown

doc/test_markdown.md

@@ -0,0 +1,16 @@
+# Markdown Header
+
+Foo in **Markdown**, which means we can do **inline *italics* like this**
+
+## Markdown Lower Header
+
+More second-level content.
+
+[A link](http://rtfd.org)
+
+You can even do:
+
+```bash
+
+Code blocks
+```