diff --git a/.github/workflows/_checks.yml b/.github/workflows/_checks.yml
index 1444b27..0fd0b7f 100644
--- a/.github/workflows/_checks.yml
+++ b/.github/workflows/_checks.yml
@@ -16,6 +16,14 @@ jobs:
       - run: uv python pin 3.11
       - run: just install lint-ci
 
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: extractions/setup-just@v4
+      - uses: astral-sh/setup-uv@v8.2.0
+      - run: just docs-build
+
   pytest:
     runs-on: ubuntu-latest
     strategy:
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 9a8a4ca..cba3dda 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,2 +1,2 @@
-mkdocs
-mkdocs-material
+mkdocs>=1.6,<2
+mkdocs-material>=9,<10
diff --git a/mkdocs.yml b/mkdocs.yml
index 1ae45fa..4f9c3d1 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -52,6 +52,12 @@ theme:
 extra_css:
   - css/brand.css
 
+validation:
+  omitted_files: warn
+  absolute_links: warn
+  unrecognized_links: warn
+  anchors: warn
+
 markdown_extensions:
   - toc:
       permalink: true