diff --git a/requirements.txt b/requirements.txt
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,6 +6,6 @@
 sphinxcontrib-images
 sphinxcontrib-programoutput
 sphinx-tabs
-recommonmark
 sphinx_rtd_theme
 sphinx-click
+myst-parser
diff --git a/swh/docs/sphinx/conf.py b/swh/docs/sphinx/conf.py
--- a/swh/docs/sphinx/conf.py
+++ b/swh/docs/sphinx/conf.py
@@ -29,6 +29,7 @@
     "sphinx_rtd_theme",
     "sphinx.ext.graphviz",
     "sphinx_click.ext",
+    "myst_parser",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -37,12 +38,7 @@
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
-source_suffix = [".rst", ".md"]
-# source_suffix = '.rst'
-
-source_parsers = {
-    ".md": "recommonmark.parser.CommonMarkParser",
-}
+source_suffix = ".rst"
 
 # The master toctree document.
 master_doc = "index"