diff --git a/docs/conf.py b/docs/conf.py
index 99f071b94..11c0b2310 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -59,6 +59,7 @@ autodoc_mock_imports = [
     "ldap",
     "persisting_theory",
     "rest_framework",
+    "drf_spectacular",
 ]
 add_module_names = False
 # Add any paths that contain templates here, relative to this directory.
@@ -73,6 +74,9 @@ source_suffix = ".rst"
 # The root toctree document.
 root_doc = "index"
 
+# Enable colon fences
+myst_enable_extensions = ["colon_fence"]
+
 # General information about the project.
 year = datetime.datetime.now().year
 project = "funkwhale"
@@ -115,7 +119,7 @@ html_theme = "sphinx_rtd_theme"
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-#html_theme_options = {}
+# html_theme_options = {}
 html_context = {
     "display_gitlab": True,
     "gitlab_host": "dev.funkwhale.audio",
@@ -160,7 +164,13 @@ latex_elements = {
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (root_doc, "funkwhale.tex", "funkwhale Documentation", "The Funkwhale Collective", "manual")
+    (
+        root_doc,
+        "funkwhale.tex",
+        "funkwhale Documentation",
+        "The Funkwhale Collective",
+        "manual",
+    )
 ]