diff --git a/cli/commands.mdx b/cli/commands.mdx
index c2f5d3f165..97322deaa3 100644
--- a/cli/commands.mdx
+++ b/cli/commands.mdx
@@ -2,7 +2,12 @@
 title: "Mintlify CLI command reference"
 sidebarTitle: "Commands"
 description: "Complete reference for Mintlify CLI commands and flags, including mint index, mint dev, mint validate, mint broken-links, and more."
-keywords: ["CLI", "mint", "commands", "flags", "reference"]
+keywords:
+  - "CLI"
+  - "mint"
+  - "commands"
+  - "flags"
+  - "reference"
 boost: 3
 ---
 
@@ -642,7 +647,7 @@ mint format
 Run the command from the root of your docs project. It walks every subdirectory, skipping paths matched by `.gitignore` and any Mintlify ignore rules. Files that already match the canonical output are left untouched.
 
 <Warning>
-  `mint format` rewrites files in place. Commit or stash your changes before running it so you can review the diff.
+  `mint format` rewrites files in place. Commit or stash your changes before running it so you can review the diff.<br /><br />Due to potentially large diffs, first resolve all important pending branches. Then create a new branch before running `mint format`.
 </Warning>
 
 When it finishes, the command prints how many MDX files were reformatted and how many failed to parse. If any file fails, the command exits with code `1` and prints the file path and error, so you can run it in CI to enforce consistent formatting.