diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 5c8a7abc..086b5d90 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -26,6 +26,17 @@ on:
     - cron: "0 0 * * 0"
 
 jobs:
+  # markdownlint:
+  #   name: markdown lint
+  #   runs-on: ubuntu-22.04
+
+  #   steps:
+  #     - name: Checkout code
+  #       uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332
+
+  #     - name: Run markdown lint
+  #       run: ./bin/lint_markdown.sh
+
   # stolen from https://raw.githubusercontent.com/exercism/github-actions/main/.github/workflows/shellcheck.yml
   shellcheck:
     name: Run shellcheck on scripts
diff --git a/bin/lint_markdown.sh b/bin/lint_markdown.sh
new file mode 100644
index 00000000..278d2c7e
--- /dev/null
+++ b/bin/lint_markdown.sh
@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -eo pipefail
+
+npx markdownlint-cli2 \
+    docs/*.md \
+    concepts/**/*.md \
+    exercises/**/*.md