diff --git a/.github/workflows/build-deploy-docs.yml b/.github/workflows/build-deploy-docs.yml
index cc76eee33..b0fd79d7b 100644
--- a/.github/workflows/build-deploy-docs.yml
+++ b/.github/workflows/build-deploy-docs.yml
@@ -32,7 +32,9 @@ jobs:
       - name: Setup mdBook
         uses: peaceiris/actions-mdbook@v2
         with:
-          mdbook-version: '0.4.40'
+          mdbook-version: '0.4.51'
+      - name: Install mdbook-alerts
+        run: cargo install mdbook-alerts
 
       - run: mdbook build docs
 
diff --git a/docs/README.md b/docs/README.md
index 59f904670..70782a110 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -5,7 +5,7 @@ The documentation of `maplibre/martin` is available at <https://maplibre.org/mar
 To build/develop this documentation locally, you can install `mdbook` and `mdbook-linkcheck`.
 
 ```bash
-cargo install mdbook
+cargo install mdbook mdbook-alerts
 ```
 
 ## Development
diff --git a/docs/book.toml b/docs/book.toml
index ca954eb6a..7bfa4e583 100644
--- a/docs/book.toml
+++ b/docs/book.toml
@@ -12,3 +12,5 @@ build-dir = "../target/book"
 curly-quotes = true
 git-repository-url = "https://github.com/maplibre/martin"
 edit-url-template = "https://github.com/maplibre/martin/edit/main/docs/{path}"
+
+[preprocessor.alerts]
diff --git a/docs/src/using-with-renderer.md b/docs/src/using-with-renderer.md
index 1ac980c83..de5171040 100644
--- a/docs/src/using-with-renderer.md
+++ b/docs/src/using-with-renderer.md
@@ -1,4 +1,7 @@
 # Map renderer specific
 
 Martin is mostly a general purpose tileserver.
-The exception is style serving, as it is specific to [maplibre](https://maplibre.org).
+It can thus be used in conjunction with renderers that are not [maplibre](https://maplibre.org).
+
+> [!WARNING]
+> Style serving, as it is specific to [maplibre](https://maplibre.org).
diff --git a/justfile b/justfile
index 01ce2d9ee..88c3c7ea9 100755
--- a/justfile
+++ b/justfile
@@ -78,7 +78,7 @@ bless-int:
     rm -rf tests/expected && mv tests/output tests/expected
 
 # Build and open mdbook documentation
-book:  (cargo-install 'mdbook')
+book:  (cargo-install 'mdbook') (cargo-install 'mdbook-alerts')
     mdbook serve docs --open --port 8321
 
 # Quick compile without building a binary