diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index bb2dfa1a6897347679b3da2cb1bb15548e155a8b..58dd6dcaae65b441d33d4dccbbf81a059288493d 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -22,3 +22,21 @@ repos:
     hooks:
       - id: bandit
         exclude: beat/editor/test
+  - repo: local
+    hooks:
+      - id: sphinx-build
+        name: sphinx build
+        entry: python -m sphinx.cmd.build
+        args: [-a, -E, -W, doc, sphinx]
+        language: system
+        files: ^doc/
+        types: [file]
+        pass_filenames: false
+      - id: sphinx-doctest
+        name: sphinx doctest
+        entry: python -m sphinx.cmd.build
+        args: [-a, -E, -b, doctest, doc, sphinx]
+        language: system
+        files: ^doc/
+        types: [file]
+        pass_filenames: false