try this

.github/workflows/markdown-tests.yaml

@@ -88,13 +88,12 @@ jobs:
         id: cache-uv
         with:
           path: ~/.cache/uv
-          key: uvcache-markdown-tests-${{ runner.os }}-${{ steps.setup_python.outputs.python-version }}-${{ hashFiles('requirements-client.txt', 'requirements.txt', 'requirements-dev.txt', 'requirements-markdown.txt') }}
+          key: uvcache-markdown-tests-${{ runner.os }}-${{ steps.setup_python.outputs.python-version }}-${{ hashFiles('pyproject.toml') }}
 
       - name: Install packages
         run: |
           python -m pip install -U uv
-          uv pip install --upgrade -r requirements-markdown-tests.txt
-          uv pip install --upgrade -e '.[dev]'
+          uv pip install --upgrade -e '.[markdown-docs,dev]'
           uv pip uninstall pytest-benchmark
 
       - name: Start server

pyproject.toml

@@ -95,8 +95,30 @@ otel = [
     "opentelemetry-exporter-otlp>=1.27.0,<2.0.0",
     "opentelemetry-instrumentation>=0.48b0,<1.0.0",
     "opentelemetry-instrumentation-logging>=0.48b0,<1.0.0",
-    "opentelemetry-test-utils>=0.48b0,<1.0.0"
+    "opentelemetry-test-utils>=0.48b0,<1.0.0",
 ]
+
+markdown-docs = [
+    "pytest-markdown-docs>=0.6.0",
+    "prefect[aws]",
+    "prefect[azure]",
+    "prefect[bitbucket]",
+    "prefect[dask]",
+    "prefect[databricks]",
+    # "prefect[dbt]",
+    "prefect[email]",
+    "prefect[gcp]",
+    "prefect[github]",
+    "prefect[gitlab]",
+    "prefect[kubernetes]",
+    "prefect[ray]",
+    "prefect[shell]",
+    "prefect[slack]",
+    "prefect[snowflake]",
+    "prefect[sqlalchemy]",
+]
+
+
 # Infrastructure extras
 aws = ["prefect-aws>=0.5.0"]
 azure = ["prefect-azure>=0.4.0"]
@@ -169,13 +191,10 @@ dev = [
     "opentelemetry-exporter-otlp>=1.27.0,<2.0.0",
     "opentelemetry-instrumentation>=0.48b0,<1.0.0",
     "opentelemetry-instrumentation-logging>=0.48b0,<1.0.0",
-    "opentelemetry-test-utils>=0.48b0,<1.0.0"
+    "opentelemetry-test-utils>=0.48b0,<1.0.0",
 ]
 
-benchmark = [
-    "pytest-benchmark>=5.1.0",
-    "pytest-codspeed>=2.2.1",
-]
+benchmark = ["pytest-benchmark>=5.1.0", "pytest-codspeed>=2.2.1"]
 
 [tool.hatch.build.targets.sdist]
 include = ["src/prefect", "README.md", "LICENSE", "pyproject.toml"]