diff --git a/docs/mdbook/book.toml b/docs/mdbook/book.toml
index 59e8c630..386386ac 100644
--- a/docs/mdbook/book.toml
+++ b/docs/mdbook/book.toml
@@ -8,3 +8,5 @@ title = "nixvim docs"
 [output.html.fold]
 enable = true
 level = 0
+
+[preprocessor.alerts]
diff --git a/docs/mdbook/default.nix b/docs/mdbook/default.nix
index d3ab7b91..93d3585f 100644
--- a/docs/mdbook/default.nix
+++ b/docs/mdbook/default.nix
@@ -252,7 +252,10 @@ pkgs.stdenv.mkDerivation {
 
   phases = [ "buildPhase" ];
 
-  buildInputs = [ pkgs.mdbook ];
+  buildInputs = [
+    pkgs.mdbook
+    pkgs.mdbook-alerts
+  ];
   inputs = lib.sourceFilesBySuffices ./. [
     ".md"
     ".toml"