Render .md files with MyST-parser

Author: mwouts

docs/environment.yml

@@ -6,8 +6,8 @@ dependencies:
   - python=3.7
   - sphinx
   - sphinx_rtd_theme
-  - recommonmark
   - pillow
   - pip
   - pip:
-      - readthedocs-sphinx-ext
+      - myst_parser
+      - readthedocs-sphinx-ext

docs/source/conf.py

@@ -13,9 +13,6 @@
 import os
 import shlex
 
-# Needed for conversion from markdown to html
-import recommonmark.parser
-
 # 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.
@@ -35,17 +32,12 @@
     'sphinx.ext.napoleon',
     "sphinx.ext.extlinks",
     "sphinx.ext.viewcode",
-    "recommonmark"
+    "myst_parser"
 ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
-# 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']

requirements-doc.txt

@@ -1,3 +1,3 @@
 sphinx_rtd_theme
 sphinx
-recommonmark
+myst-parser