From f9cdc54382bee52011d0359644a5f1c63880d3f8 Mon Sep 17 00:00:00 2001
From: "Sean T. Allen" <sean@seantallen.com>
Date: Sun, 9 Aug 2026 23:56:21 -0400
Subject: [PATCH 1/3] Replace super-linter with dedicated markdownlint image

---
 .github/workflows/pr.yml                         | 16 +++++-----------
 .../.markdown-lint.yml => .markdownlint.yml      |  3 ++-
 2 files changed, 7 insertions(+), 12 deletions(-)
 rename .github/linters/.markdown-lint.yml => .markdownlint.yml (52%)

diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml
index 91782a08..4c32069e 100644
--- a/.github/workflows/pr.yml
+++ b/.github/workflows/pr.yml
@@ -10,19 +10,13 @@ permissions:
   packages: read
 
 jobs:
-  superlinter:
-    name: Lint markdown and yaml
+  lint-markdown:
+    name: Lint markdown
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout source
-        uses: actions/checkout@v6.0.2
-      - name: Lint codebase
-        uses: docker://github/super-linter:v3.8.3
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          VALIDATE_ALL_CODEBASE: true
-          VALIDATE_MD: true
-          VALIDATE_YAML: true
+      - uses: actions/checkout@v6.0.2
+      - name: Lint markdown
+        uses: docker://ghcr.io/ponylang/shared-docker-ci-markdownlint:20260810
 
   check-spelling:
     name: Spellcheck markdown
diff --git a/.github/linters/.markdown-lint.yml b/.markdownlint.yml
similarity index 52%
rename from .github/linters/.markdown-lint.yml
rename to .markdownlint.yml
index 63482d07..6081825f 100644
--- a/.github/linters/.markdown-lint.yml
+++ b/.markdownlint.yml
@@ -2,5 +2,6 @@
   "MD007": { "indent": 4 },
   "MD013": false,
   "MD026": false,
-  "MD033": { "allowed_elements": ["sup"] }
+  "MD033": { "allowed_elements": ["sup"] },
+  "MD051": false
 }

From 3c91589e513f3cdf7cb919139b03236995f0fd5b Mon Sep 17 00:00:00 2001
From: "Sean T. Allen" <sean@seantallen.com>
Date: Mon, 10 Aug 2026 00:00:17 -0400
Subject: [PATCH 2/3] Disable MD050 and MD056 rules new to markdownlint-cli2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

These rules (strong-style and table-column-count) are enforced by
markdownlint-cli2 v0.17.2 but weren't present in super-linter v3.8.3.
Disable them to keep the migration mechanical — no content changes.
---
 .markdownlint.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.markdownlint.yml b/.markdownlint.yml
index 6081825f..f6f4e1f9 100644
--- a/.markdownlint.yml
+++ b/.markdownlint.yml
@@ -3,5 +3,7 @@
   "MD013": false,
   "MD026": false,
   "MD033": { "allowed_elements": ["sup"] },
-  "MD051": false
+  "MD050": false,
+  "MD051": false,
+  "MD056": false
 }

From 6c8cfa8fed45f4646794c92cb15861f426424100 Mon Sep 17 00:00:00 2001
From: "Sean T. Allen" <sean@seantallen.com>
Date: Mon, 10 Aug 2026 00:03:15 -0400
Subject: [PATCH 3/3] Disable MD049 rule new to markdownlint-cli2

---
 .markdownlint.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.markdownlint.yml b/.markdownlint.yml
index f6f4e1f9..0e4f2eca 100644
--- a/.markdownlint.yml
+++ b/.markdownlint.yml
@@ -3,6 +3,7 @@
   "MD013": false,
   "MD026": false,
   "MD033": { "allowed_elements": ["sup"] },
+  "MD049": false,
   "MD050": false,
   "MD051": false,
   "MD056": false