diff --git a/.vale-ci.ini b/.vale-ci.ini
index 0ecef14e79..7ee2572aed 100644
--- a/.vale-ci.ini
+++ b/.vale-ci.ini
@@ -11,5 +11,8 @@ Temporal.complexwords = NO
 Temporal.programming = NO
 Temporal.WordList = NO
 
+; ignore MDX custom heading-ID comments, e.g. {/* #ha-worker-patterns */}
+TokenIgnores = (\{/\*[^\n]*?\*/\})
+
 [formats]
 mdx = md
diff --git a/vale/test/headings-good.md b/vale/test/headings-good.md
index bfe491b49a..59543cd477 100644
--- a/vale/test/headings-good.md
+++ b/vale/test/headings-good.md
@@ -41,3 +41,5 @@
 ## Update a running Workflow
 
 ## Durable External Storage for large payloads
+
+## Highly available Worker patterns {/* #ha-worker-patterns */}
diff --git a/vale/test/terms-bad.md b/vale/test/terms-bad.md
index 23450c994a..4dbadd1d62 100644
--- a/vale/test/terms-bad.md
+++ b/vale/test/terms-bad.md
@@ -27,3 +27,5 @@ Use heartbeating to report activity progress.
 The codec server provides remote payload encoding.
 
 A child workflow execution inherits the parent close policy.
+
+## Highly available worker patterns {/* #ha-worker-patterns */}