Support markdown.

conf.py

@@ -16,6 +16,8 @@
 import sys
 import os
 
+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
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -47,7 +49,8 @@ templates_path = ['templates']
 # The suffix of source filenames.
 source_suffix = ['.rst', '.md', '.c', '.h']
 
-source_parsers = {'.c': "c2rst.CStrip", '.h': "c2rst.CStrip"}
+source_parsers = {'.md': CommonMarkParser,
+                  '.c': "c2rst.CStrip", '.h': "c2rst.CStrip"}
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'

docs/supported_ports.rst

@@ -7,4 +7,4 @@ the Atmel SAMD21 port
 .. toctree::
     :maxdepth: 2
 
-    atmel-samd/README.md
+    ../atmel-samd/README

index.rst

@@ -23,6 +23,9 @@ started guides.
     docs/supported_ports.rst
     docs/unsupported_ports.rst
     docs/library/index.rst
+    README
+    CONTRIBUTING
+    CODE_OF_CONDUCT
     license.rst
 
 Indices and tables