diff --git a/package.json b/package.json
index c93e7b2..6ec3848 100644
--- a/package.json
+++ b/package.json
@@ -1,9 +1,9 @@
 {
   "scripts": {
-    "setup": "npm install && pip3 install -r requirements.txt",
+    "setup": "npm install && pip3 install -r requirements.txt && (command -v asdf >/dev/null && asdf reshim python || true)",
     "lint": "markdownlint-cli2 '**/*.md' '!node_modules'",
-    "build": "markdownlint-cli2 '**/*.md' '!node_modules' && mkdocs build",
-    "serve": "markdownlint-cli2 '**/*.md' '!node_modules' && mkdocs serve"
+    "build": "markdownlint-cli2 '**/*.md' '!node_modules' '!.venv' && mkdocs build",
+    "serve": "markdownlint-cli2 '**/*.md' '!node_modules' '!.venv' && mkdocs serve"
   },
   "devDependencies": {
     "markdownlint-cli2": "^0.14.0"
diff --git a/requirements.txt b/requirements.txt
index 4158492..fa0de37 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,5 @@
-mkdocs
+mkdocs ~= 1.6
 pymdown-extensions
 mkdocs-material ~= 9.0, >= 9.0.3
 markdown-include
 mdx_truly_sane_lists
-