From 7630322f64feb39e7ea8788073b249e7e61bd01b Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 27 Apr 2026 11:11:24 +0100
Subject: [PATCH] docs: format migration guides

---
 docs/install/migrating-claude.md | 6 ++++++
 docs/install/migrating.md        | 3 +++
 2 files changed, 9 insertions(+)

diff --git a/docs/install/migrating-claude.md b/docs/install/migrating-claude.md
index a2eb05ac5c6..5d710717da3 100644
--- a/docs/install/migrating-claude.md
+++ b/docs/install/migrating-claude.md
@@ -27,6 +27,7 @@ Onboarding imports require a fresh OpenClaw setup. If you already have local Ope
     ```bash
     openclaw onboard --import-from claude --import-source ~/.claude
     ```
+
   </Tab>
   <Tab title="CLI">
     Use `openclaw migrate` for scripted or repeatable runs. See [`openclaw migrate`](/cli/migrate) for the full reference.
@@ -37,6 +38,7 @@ Onboarding imports require a fresh OpenClaw setup. If you already have local Ope
     ```
 
     Add `--from <path>` to import a specific Claude Code home or project root.
+
   </Tab>
 </Tabs>
 
@@ -86,6 +88,7 @@ When `--from` points at a project root, OpenClaw imports only that project's Cla
     ```
 
     The plan lists everything that will change, including conflicts, skipped items, and sensitive values redacted from nested MCP `env` or `headers` fields.
+
   </Step>
   <Step title="Apply with backup">
     ```bash
@@ -93,6 +96,7 @@ When `--from` points at a project root, OpenClaw imports only that project's Cla
     ```
 
     OpenClaw creates and verifies a backup before applying.
+
   </Step>
   <Step title="Run doctor">
     ```bash
@@ -100,6 +104,7 @@ When `--from` points at a project root, OpenClaw imports only that project's Cla
     ```
 
     [Doctor](/gateway/doctor) checks for config or state issues after the import.
+
   </Step>
   <Step title="Restart and verify">
     ```bash
@@ -108,6 +113,7 @@ When `--from` points at a project root, OpenClaw imports only that project's Cla
     ```
 
     Confirm the gateway is healthy and your imported instructions, MCP servers, and skills are loaded.
+
   </Step>
 </Steps>
 
diff --git a/docs/install/migrating.md b/docs/install/migrating.md
index f74e64181a1..b71d7d9e10d 100644
--- a/docs/install/migrating.md
+++ b/docs/install/migrating.md
@@ -51,6 +51,7 @@ Run `openclaw status` on the old machine to confirm your state directory path. C
     ```
 
     If you use multiple profiles (for example `~/.openclaw-work`), archive each separately.
+
   </Step>
 
   <Step title="Install OpenClaw on the new machine">
@@ -66,6 +67,7 @@ Run `openclaw status` on the old machine to confirm your state directory path. C
     ```
 
     Ensure hidden directories were included and file ownership matches the user that will run the gateway.
+
   </Step>
 
   <Step title="Run doctor and verify">
@@ -76,6 +78,7 @@ Run `openclaw status` on the old machine to confirm your state directory path. C
     openclaw gateway restart
     openclaw status
     ```
+
   </Step>
 </Steps>