diff --git a/scripts/generate_vocab_docs.sh b/scripts/generate_vocab_docs.sh
index 5eff275..afbcc52 100755
--- a/scripts/generate_vocab_docs.sh
+++ b/scripts/generate_vocab_docs.sh
@@ -2,6 +2,7 @@
 #
 # Regenerates the vocabulary markdown files from the GH sources
 #
+# Uses 'vocab' CLI from vocab_tools (installed via pipx in workflow)
 #
 
 # get the core sample type vocabularies
@@ -15,7 +16,7 @@ mkdir -p "${DEST_FOLDER}"
 for src in ${SOURCES[@]}; do
     fname="${src%%.*}.qmd"
     echo "Generating ${fname}..."
-    python "${SCRIPT_FOLDER}/vocab2md.py" "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
+    vocab markdown "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
 done
 
 #
@@ -33,7 +34,7 @@ mkdir -p "${DEST_FOLDER}"
 for src in ${SOURCES[@]}; do
     fname="${src%%.*}.md"
     echo "Generating ${fname}..."
-    python "${SCRIPT_FOLDER}/vocab2md.py" "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
+    vocab markdown "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
 done
 
 SOURCE_BASE="https://raw.githubusercontent.com/isamplesorg/metadata_profile_archaeology/main/vocabulary/"
@@ -43,7 +44,7 @@ mkdir -p "${DEST_FOLDER}"
 for src in ${SOURCES[@]}; do
     fname="${src%%.*}.md"
     echo "Generating ${fname}..."
-    python "${SCRIPT_FOLDER}/vocab2md.py" "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
+    vocab markdown "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
 done
 
 SOURCE_BASE="https://raw.githubusercontent.com/isamplesorg/metadata_profile_biology/main/vocabulary/"
@@ -53,7 +54,7 @@ mkdir -p "${DEST_FOLDER}"
 for src in ${SOURCES[@]}; do
     fname="${src%%.*}.md"
     echo "Generating ${fname}..."
-    python "${SCRIPT_FOLDER}/vocab2md.py" "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
+    vocab markdown "${SOURCE_BASE}${src}" > "${DEST_FOLDER}${fname}"
 done
 
 echo "Done."