diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md
index 99bf022592..6af91f29dd 100644
--- a/docs/concepts/model-providers.md
+++ b/docs/concepts/model-providers.md
@@ -133,14 +133,17 @@ Moonshot uses OpenAI-compatible endpoints, so configure it as a custom provider:
 - Provider: `moonshot`
 - Auth: `MOONSHOT_API_KEY`
 - Example model: `moonshot/kimi-k2.5`
-- Kimi K2 model IDs:
-  {/_ moonshot-kimi-k2-model-refs:start _/}
-  - `moonshot/kimi-k2.5`
-  - `moonshot/kimi-k2-0905-preview`
-  - `moonshot/kimi-k2-turbo-preview`
-  - `moonshot/kimi-k2-thinking`
-  - `moonshot/kimi-k2-thinking-turbo`
-    {/_ moonshot-kimi-k2-model-refs:end _/}
+
+Kimi K2 model IDs:
+
+{/_ moonshot-kimi-k2-model-refs:start _/ && null}
+
+- `moonshot/kimi-k2.5`
+- `moonshot/kimi-k2-0905-preview`
+- `moonshot/kimi-k2-turbo-preview`
+- `moonshot/kimi-k2-thinking`
+- `moonshot/kimi-k2-thinking-turbo`
+  {/_ moonshot-kimi-k2-model-refs:end _/ && null}
 
 ```json5
 {
diff --git a/docs/providers/moonshot.md b/docs/providers/moonshot.md
index c1abc5b45c..6e6ec52959 100644
--- a/docs/providers/moonshot.md
+++ b/docs/providers/moonshot.md
@@ -15,14 +15,14 @@ Kimi Coding with `kimi-coding/k2p5`.
 
 Current Kimi K2 model IDs:
 
-{/_ moonshot-kimi-k2-ids:start _/}
+{/_ moonshot-kimi-k2-ids:start _/ && null}
 
 - `kimi-k2.5`
 - `kimi-k2-0905-preview`
 - `kimi-k2-turbo-preview`
 - `kimi-k2-thinking`
 - `kimi-k2-thinking-turbo`
-  {/_ moonshot-kimi-k2-ids:end _/}
+  {/_ moonshot-kimi-k2-ids:end _/ && null}
 
 ```bash
 openclaw onboard --auth-choice moonshot-api-key
diff --git a/scripts/sync-moonshot-docs.ts b/scripts/sync-moonshot-docs.ts
index 1634df2e78..c5afc543cf 100644
--- a/scripts/sync-moonshot-docs.ts
+++ b/scripts/sync-moonshot-docs.ts
@@ -90,8 +90,8 @@ async function syncMoonshotDocs() {
   let moonshotText = await readFile(moonshotDoc, "utf8");
   moonshotText = replaceBlockLines(
     moonshotText,
-    "<!-- moonshot-kimi-k2-ids:start -->",
-    "<!-- moonshot-kimi-k2-ids:end -->",
+    "{/_ moonshot-kimi-k2-ids:start _/ && null}",
+    "{/_ moonshot-kimi-k2-ids:end _/ && null}",
     renderKimiK2Ids(""),
   );
   moonshotText = replaceBlockLines(
@@ -110,8 +110,8 @@ async function syncMoonshotDocs() {
   let conceptsText = await readFile(conceptsDoc, "utf8");
   conceptsText = replaceBlockLines(
     conceptsText,
-    "<!-- moonshot-kimi-k2-model-refs:start -->",
-    "<!-- moonshot-kimi-k2-model-refs:end -->",
+    "{/_ moonshot-kimi-k2-model-refs:start _/ && null}",
+    "{/_ moonshot-kimi-k2-model-refs:end _/ && null}",
     renderKimiK2Ids("moonshot/"),
   );