diff --git a/.github/workflows/build-deploy-docs.yml b/.github/workflows/build-deploy-docs.yml
index fcf1def64..cc76eee33 100644
--- a/.github/workflows/build-deploy-docs.yml
+++ b/.github/workflows/build-deploy-docs.yml
@@ -16,7 +16,7 @@ jobs:
       - uses: Swatinem/rust-cache@v2
 
       - name: 'Validate .md files (use "just fmt-md" to fix)'
-        uses: DavidAnson/markdownlint-cli2-action@v19
+        uses: DavidAnson/markdownlint-cli2-action@v20
         with:
           config: '.github/files/config.markdownlint-cli2.jsonc'
 
diff --git a/docs/src/run-with-nginx.md b/docs/src/run-with-nginx.md
index 544588fc0..3f6558929 100644
--- a/docs/src/run-with-nginx.md
+++ b/docs/src/run-with-nginx.md
@@ -36,7 +36,7 @@ services:
       - ./pg_data:/var/lib/postgresql/data
 ```
 
-You can find an example NGINX configuration file [here](https://github.com/maplibre/martin/blob/main/demo/frontend/nginx.conf).
+You can [find an example NGINX configuration file here](https://github.com/maplibre/martin/blob/main/demo/frontend/nginx.conf).
 
 ### Rewriting URLs
 
@@ -91,4 +91,4 @@ http {
 }
 ```
 
-You can find an example NGINX configuration file [here](https://github.com/maplibre/martin/blob/main/demo/frontend/nginx.conf).
+You can [find an example NGINX configuration file here](https://github.com/maplibre/martin/blob/main/demo/frontend/nginx.conf).
diff --git a/docs/src/using-with-mapbox.md b/docs/src/using-with-mapbox.md
index 3bef04a1b..64f0828b7 100644
--- a/docs/src/using-with-mapbox.md
+++ b/docs/src/using-with-mapbox.md
@@ -1,13 +1,12 @@
 ## Using with Mapbox
 
-[Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) is a JavaScript library for interactive, customizable vector maps
-on the web. Mapbox GL JS v1.x was open source, and it was forked as MapLibre, so using Martin with Mapbox is similar to
-MapLibre described [here](using-with-maplibre.md). Mapbox GL JS can
-accept [MVT vector tiles](https://github.com/mapbox/vector-tile-spec) generated by Martin, and
-applies [a style](https://maplibre.org/maplibre-style-spec/) to them to draw a map using Web GL.
+[Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) is a JavaScript library for interactive, customizable vector maps on the web.
+Mapbox GL JS v1.x was open source, and it was forked as MapLibre, so [using Martin with Mapbox is similar to MapLibre](using-with-maplibre.md).
+Mapbox GL JS can accept [MVT vector tiles](https://github.com/mapbox/vector-tile-spec) generated by Martin, and applies [a style](https://maplibre.org/maplibre-style-spec/) to them to draw a map using Web GL.
 
-You can add a layer to the map and specify Martin TileJSON endpoint as a vector source URL. You should also specify
-a `source-layer` property. For [Table Sources](sources-pg-tables.md) it is `{table_name}` by default.
+You can add a layer to the map and specify Martin TileJSON endpoint as a vector source URL.
+You should also specify a `source-layer` property.
+For [Table Sources](sources-pg-tables.md) it is `{table_name}` by default.
 
 ```js
 map.addLayer({