diff --git a/.readthedocs.yml b/.readthedocs.yml
index 3d7a86b2..900dba1e 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -4,8 +4,14 @@
 
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  apt_packages:
+  - graphviz
+
 python:
-  version: 3.8
   install:
   - requirements: doc/requirements.txt
-  system_packages: true
+  system_packages: false
diff --git a/doc/conf.py b/doc/conf.py
index 4b3978af..8111c86c 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -36,6 +36,7 @@ sys.path.insert(0, os.path.abspath("../scripts"))
 extensions = [
     #'sphinx.ext.autodoc',
     #'sphinx.ext.autosummary',
+    "myst_parser",
     "sphinx.ext.autosectionlabel",
     "sphinx.ext.intersphinx",
     "sphinx.ext.todo",
diff --git a/doc/release_notes.rst b/doc/release_notes.rst
index 9be10a4a..8e6bfdd4 100644
--- a/doc/release_notes.rst
+++ b/doc/release_notes.rst
@@ -17,7 +17,7 @@ Upcoming Release
 
 * Renamed script file from PyPSA-EUR ``build_load_data`` to ``build_electricity_demand`` and ``retrieve_load_data`` to ``retrieve_electricity_demand``.
 
-
+* Fix docs readthedocs built
 
 * Add plain hydrogen turbine as additional re-electrification option besides
   hydrogen fuel cell. Add switches for both re-electrification options under
diff --git a/doc/requirements.txt b/doc/requirements.txt
index d5c71da9..2f08b8d9 100644
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -2,9 +2,11 @@
 #
 # SPDX-License-Identifier: CC0-1.0
 
+setuptools
 sphinx
 sphinx_book_theme
 sphinxcontrib-bibtex
+myst-parser  # recommark is deprecated, https://stackoverflow.com/a/71660856/13573820
 
 pypsa
 vresutils>=0.3.1