From 04cb5fe5037b6b9e9f3ef6513f212e19522be32b Mon Sep 17 00:00:00 2001
From: Carol Willing <carolcode@willingconsulting.com>
Date: Tue, 5 Jan 2016 16:05:17 -0800
Subject: [PATCH] Add recommonmark parser for markdown

---
 docs/source/conf.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index fa0b005a..b4b0f360 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -15,7 +15,8 @@
 import sys
 import os
 import shlex
-from CommonMark import Parser, HtmlRenderer
+
+# Needed for conversion from markdown to html
 import recommonmark.parser
 
 # If extensions (or modules to document with autodoc) are in another directory,
@@ -40,13 +41,14 @@ extensions = [
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-# source_suffix = ['.rst', '.md']
+# Jupyter uses recommonmark's parser to convert markdown
 source_parsers = {
     '.md': 'recommonmark.parser.CommonMarkParser',
 }
 
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
 source_suffix = ['.rst', '.md']
 
 # The encoding of source files.