diff --git a/docs/reference/secretref-credential-surface.md b/docs/reference/secretref-credential-surface.md
index c8058b87b19..05fac435c1a 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 f86cad036f0..bd3052ef6d2 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(