add steps for CLI migration

Author: ethanpalm

api-playground/migrating-from-mdx.mdx

@@ -9,7 +9,47 @@ If you are currently using individual `MDX` pages for your API endpoints, you ca
 
 You can define metadata and content for each endpoint in your OpenAPI specification and organize endpoints where you want them in your navigation.
 
-## Migration steps
+## CLI migration
+
+The `mint migrate-mdx` command is the recommended way to migrate from MDX endpoint pages to autogenerated pages.
+
+This command:
+- Parses your `docs.json` navigation structure.
+- Identifies MDX pages that reference OpenAPI endpoints.
+- Extracts content from MDX files and moves it to the `x-mint` extension in your OpenAPI specification.
+- Migrates any existing `x-mcp` data into `x-mint`.
+- Updates your `docs.json` to reference the OpenAPI endpoints directly instead of MDX files.
+- Deletes the original MDX endpoint files.
+
+<Info>
+If you already have `x-mint` defined for an endpoint and also have an MDX page with content for that endpoint, the MDX content will overwrite existing `x-mint` settings.
+
+If you have multiple MDX pages for the same endpoint with different content, the script will use the content from the page that appears last in your `docs.json`.
+
+The migration tool does not support previewing changes before applying them.
+</Info>
+
+<Steps>
+<Step title="Prepare your OpenAPI specification.">
+    Ensure your OpenAPI specification is valid and includes all endpoints you want to document.
+
+    Any MDX pages you want to migrate must have the `openapi:` frontmatter referencing an endpoint.
+
+    <Tip>
+      Validate your OpenAPI file using the [Swagger Editor](https://editor.swagger.io/) or [Mint CLI](https://www.npmjs.com/package/mint).
+    </Tip>
+  </Step>
+  <Step title="Install the Mint CLI">
+    If needed, install or update the [Mint CLI](/installation).
+  </Step>
+  <Step title="Run the migration command.">
+    ```bash
+    mint migrate-mdx
+    ```
+  </Step>
+</Steps>
+
+## Manual migration steps
 
 <Steps>
   <Step title="Prepare your OpenAPI specification.">