diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 8e1cd1806f2..d59f31df4b4 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -8,6 +8,7 @@ on:
     types: [opened, synchronize, reopened]
     paths:
       - "docs/**"
+      - "README.md"
       - "pyproject.toml"
       - "uv.lock"
       - ".github/workflows/docs.yaml"
diff --git a/README.md b/README.md
index 4e866a772d0..82e17730cec 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,8 @@ NVIDIA NemoClaw is an open source stack that simplifies running [OpenClaw](https
 
 Follow these steps to get started with NemoClaw and your first sandboxed OpenClaw agent.
 
-> [!NOTE]
+> **ℹ️ Note**
+>
 > NemoClaw creates a fresh OpenClaw instance inside the sandbox during onboarding.
 
 <!-- start-quickstart-guide -->
@@ -60,8 +61,9 @@ The sandbox image is approximately 2.4 GB compressed. During image push, the Doc
 | macOS | Podman | Not supported yet. NemoClaw currently depends on OpenShell support for Podman on macOS. |
 | Windows WSL | Docker Desktop (WSL backend) | Supported target path |
 
-> [!TIP]
-> For DGX Spark, follow the [DGX Spark setup guide](spark-install.md). It covers Spark-specific prerequisites, such as cgroup v2 and Docker configuration, before running the standard installer.
+> **💡 Tip**
+>
+> For DGX Spark, follow the [DGX Spark setup guide](https://github.com/NVIDIA/NemoClaw/blob/main/spark-install.md). It covers Spark-specific prerequisites, such as cgroup v2 and Docker configuration, before running the standard installer.
 
 ### Install NemoClaw and Onboard OpenClaw Agent
 
@@ -108,7 +110,8 @@ sandbox@my-assistant:~$ openclaw tui
 
 Send a test message to the agent and verify you receive a response.
 
-> [!NOTE]
+> **ℹ️ Note**
+>
 > The TUI is best for interactive back-and-forth. If you need the full text of a long response (for example, large code generation output), use the CLI instead:
 >
 > ```console