diff --git a/mkdocs.yml b/mkdocs.yml
index 385738823b..a41839c12f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -109,7 +109,8 @@ markdown_extensions:
       class: mermaid
       format: !!python/name:pymdownx.superfences.fence_code_format ''
 - pymdownx.betterem
-- pymdownx.highlight
+- pymdownx.highlight:
+    linenums: !ENV [LINENUMS, false]
 - pymdownx.blocks.details
 - pymdownx.blocks.admonition:
     types:
diff --git a/scripts/docs-live.sh b/scripts/docs-live.sh
index f9d31ba361..b6071fdb97 100755
--- a/scripts/docs-live.sh
+++ b/scripts/docs-live.sh
@@ -4,4 +4,4 @@ set -e
 
 export DYLD_FALLBACK_LIBRARY_PATH="/opt/homebrew/lib"
 
-mkdocs serve --dev-addr 127.0.0.1:8008
+LINENUMS="true" mkdocs serve --dev-addr 127.0.0.1:8008