From 490670128b82fa4f2d755e46dd7bb830d830db4c Mon Sep 17 00:00:00 2001
From: joshavant <830519+joshavant@users.noreply.github.com>
Date: Tue, 3 Mar 2026 14:00:09 -0600
Subject: [PATCH] fix(docs): avoid MDX regex markers in secretref page

---
 docs/reference/secretref-credential-surface.md | 8 ++++----
 src/secrets/target-registry.test.ts            | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/reference/secretref-credential-surface.md b/docs/reference/secretref-credential-surface.md
index 05fac435c1a..35b3b9f84cf 100644
--- a/docs/reference/secretref-credential-surface.md
+++ b/docs/reference/secretref-credential-surface.md
@@ -20,7 +20,7 @@ Scope intent:
 
 ### `openclaw.json` targets (`secrets configure` + `secrets apply` + `secrets audit`)
 
-{/_ secretref-supported-list-start _/}
+[//]: # "secretref-supported-list-start"
 
 - `models.providers.*.apiKey`
 - `skills.entries.*.apiKey`
@@ -89,7 +89,7 @@ Scope intent:
 
 - `profiles.*.keyRef` (`type: "api_key"`)
 - `profiles.*.tokenRef` (`type: "token"`)
-  {/_ secretref-supported-list-end _/}
+  [//]: # (secretref-supported-list-end)
 
 Notes:
 
@@ -104,7 +104,7 @@ Notes:
 
 Out-of-scope credentials include:
 
-{/_ secretref-unsupported-list-start _/}
+[//]: # "secretref-unsupported-list-start"
 
 - `gateway.auth.token`
 - `commands.ownerDisplaySecret`
@@ -116,7 +116,7 @@ Out-of-scope credentials include:
 - `auth-profiles.oauth.*`
 - `discord.threadBindings.*.webhookToken`
 - `whatsapp.creds.json`
-  {/_ secretref-unsupported-list-end _/}
+  [//]: # (secretref-unsupported-list-end)
 
 Rationale:
 
diff --git a/src/secrets/target-registry.test.ts b/src/secrets/target-registry.test.ts
index bd3052ef6d2..83edd0d51f5 100644
--- a/src/secrets/target-registry.test.ts
+++ b/src/secrets/target-registry.test.ts
@@ -58,12 +58,12 @@ describe("secret target registry", () => {
     };
 
     const supportedFromDocs = readMarkedCredentialList({
-      start: "{/* secretref-supported-list-start */}",
-      end: "{/* secretref-supported-list-end */}",
+      start: "[//]: # (secretref-supported-list-start)",
+      end: "[//]: # (secretref-supported-list-end)",
     });
     const unsupportedFromDocs = readMarkedCredentialList({
-      start: "{/* secretref-unsupported-list-start */}",
-      end: "{/* secretref-unsupported-list-end */}",
+      start: "[//]: # (secretref-unsupported-list-start)",
+      end: "[//]: # (secretref-unsupported-list-end)",
     });
 
     const supportedFromMatrix = new Set(