diff --git a/docs/assets/extra.css b/docs/assets/extra.css
deleted file mode 100644
index 055aff201..000000000
--- a/docs/assets/extra.css
+++ /dev/null
@@ -1,10 +0,0 @@
-.codehilite {
-    background-color: hsla(0,0%,92.5%,.5);
-    overflow: auto;
-    -webkit-overflow-scrolling: touch;
-}
-
-.codehilite pre {
-    background-color: transparent;
-    padding: .525rem .6rem;
-}
diff --git a/docs/requirements.txt b/docs/requirements.txt
index d84098727..64e8ab971 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,4 +1,6 @@
 mkdocs==1.2.3
 mkdocs-material==7.1.7
+markdown_include==0.6.0
 pygments==2.15.0
 jinja2===3.0.3
+markdown==3.3.7
diff --git a/mkdocs.yml b/mkdocs.yml
index 0ff6cb746..e52876c65 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -5,14 +5,25 @@ strict: true
 theme:
   name: material
   palette:
+  - media: '(prefers-color-scheme: light)'
     primary: teal
+    scheme: default
+    toggle:
+      icon: material/brightness-7
+      name: Switch to dark mode
+  - media: '(prefers-color-scheme: dark)'
+    primary: teal
+    scheme: slate
+    toggle:
+      icon: material/brightness-4
+      name: Switch to light mode
   font:
     text: 'Work Sans'
   logo: 'assets/logo.png'
-extra_css:
-  - 'assets/extra.css'
 markdown_extensions:
-- codehilite
+- markdown_include.include
+- codehilite:
+    css_class: highlight
 - admonition
 - toc:
     permalink: true