diff --git a/docs/channels/irc.md b/docs/channels/irc.md
index 00403b6f92d..900c531da81 100644
--- a/docs/channels/irc.md
+++ b/docs/channels/irc.md
@@ -7,6 +7,8 @@ read_when:
   - You are configuring IRC allowlists, group policy, or mention gating
 ---
 
+# IRC
+
 Use IRC when you want OpenClaw in classic channels (`#room`) and direct messages.
 IRC ships as an extension plugin, but it is configured in the main config under `channels.irc`.
 
diff --git a/docs/concepts/features.md b/docs/concepts/features.md
index 1d04af9187d..03528032b40 100644
--- a/docs/concepts/features.md
+++ b/docs/concepts/features.md
@@ -5,6 +5,8 @@ read_when:
 title: "Features"
 ---
 
+# Features
+
 ## Highlights
 
 <Columns>
diff --git a/docs/gateway/network-model.md b/docs/gateway/network-model.md
index b57ff91f143..f5fb9a258ea 100644
--- a/docs/gateway/network-model.md
+++ b/docs/gateway/network-model.md
@@ -5,6 +5,8 @@ read_when:
 title: "Network model"
 ---
 
+# Network Model
+
 Most operations flow through the Gateway (`openclaw gateway`), a single long-running
 process that owns channel connections and the WebSocket control plane.
 
diff --git a/docs/reference/credits.md b/docs/reference/credits.md
index dcfeb14ca9f..ded59e442af 100644
--- a/docs/reference/credits.md
+++ b/docs/reference/credits.md
@@ -5,6 +5,8 @@ read_when:
 title: "Credits"
 ---
 
+# Credits
+
 ## The name
 
 OpenClaw = CLAW + TARDIS, because every space lobster needs a time and space machine.
diff --git a/docs/reference/templates/HEARTBEAT.md b/docs/reference/templates/HEARTBEAT.md
index 58b844f91bd..bd4720e166f 100644
--- a/docs/reference/templates/HEARTBEAT.md
+++ b/docs/reference/templates/HEARTBEAT.md
@@ -5,8 +5,10 @@ read_when:
   - Bootstrapping a workspace manually
 ---
 
-# HEARTBEAT.md
+# HEARTBEAT.md Template
 
+```markdown
 # Keep this file empty (or with only comments) to skip heartbeat API calls.
 
 # Add tasks below when you want the agent to check something periodically.
+```
diff --git a/docs/start/docs-directory.md b/docs/start/docs-directory.md
index b7c283e1aad..cbd9524f369 100644
--- a/docs/start/docs-directory.md
+++ b/docs/start/docs-directory.md
@@ -5,6 +5,8 @@ read_when:
 title: "Docs directory"
 ---
 
+# Docs Directory
+
 <Note>
 This page is a curated index. If you are new, start with [Getting Started](/start/getting-started).
 For a complete map of the docs, see [Docs hubs](/start/hubs).