diff --git a/docs/source/conf.py b/docs/source/conf.py
index b088f88f658dcf6fa0a32951be32a316f238932b..ca8a393f3c989ba05ed28066be0218d4265af3d8 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -36,6 +36,7 @@ extensions = [
     "sphinx.ext.autodoc",  # Core library for html generation from docstrings
     "sphinx.ext.autosummary",  # Create neat summary tables
     "numpydoc",  # Play along with numpydoc format
+    "myst-parser",  # Include markdown in rst files.
 ]
 autosummary_generate = True  # Turn on sphinx.ext.autosummary
 
diff --git a/docs/source/index.rst b/docs/source/index.rst
index fd8c5bded988613c79349c59865e7a653f6214aa..40796fad42c3c6a1394260c0b15e52a94b87acc4 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -20,5 +20,7 @@ Summary
 -----------
 Readme File
 -----------
-
-.. mdinclude:: ../../README.md
+Source:
+```{literalinclude} ../../README.md
+:language: md
+```