From b9910ab03713d2598a5d4fcbf95c9dc935064b68 Mon Sep 17 00:00:00 2001
From: Seb Slight <sebslight@gmail.com>
Date: Sun, 1 Feb 2026 21:38:14 -0500
Subject: [PATCH] Docs: fix Moonshot sync markers (#6789)

* Docs: fix Moonshot sync markers

* Docs: use MDX comment markers for Moonshot sync

* Docs: use markdown comment markers for Moonshot sync

* Docs: hide Moonshot sync markers in MDX
---
 docs/concepts/model-providers.md | 19 +++++++++++--------
 docs/providers/moonshot.md       |  4 ++--
 scripts/sync-moonshot-docs.ts    |  8 ++++----
 3 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md
index 99bf02259..6af91f29d 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 c1abc5b45..6e6ec5295 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 1634df2e7..c5afc543c 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/"),
   );