Add browse get markdown command (#1907)

## Summary
- Adds `browse get markdown [selector]` to convert page HTML to clean
markdown
- Defaults to body content when no selector given, accepts optional
CSS/XPath/ref selector
- Uses `node-html-markdown` for quality conversion (links, tables, code
blocks preserved)
- Useful for agents that need readable page content without HTML noise

## Usage
```bash
browse get markdown                # full page body as markdown
browse get markdown .article       # specific element
browse get markdown @0-5           # ref from snapshot
```

## Test results
| Test | Local | Remote (Browserbase) |
|------|-------|---------------------|
| `get markdown` (body default) | HN full page markdown | HN full page
markdown |
| `get markdown .titleline` (selector) | Clean link with title | Clean
link with title |

## Test plan
- [x] Test locally with no selector (full body)
- [x] Test locally with CSS selector
- [x] Test on remote Browserbase session (no selector)
- [x] Test on remote Browserbase session (with selector)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: derekmeegan

.changeset/add-get-markdown.md

@@ -0,0 +1,5 @@
+---
+"@browserbasehq/browse-cli": patch
+---
+
+Add `browse get markdown [selector]` command to convert page HTML to markdown. Defaults to body content, supports optional selector for specific elements. Uses node-html-markdown for high-quality conversion with links, tables, and code blocks preserved.

packages/cli/package.json

@@ -57,6 +57,7 @@
     "@browserbasehq/stagehand": "workspace:*",
     "commander": "^12.0.0",
     "dotenv": "^16.4.5",
+    "node-html-markdown": "^1.3.0",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0",
     "ws": "^8.18.0"

packages/cli/src/index.ts

@@ -19,6 +19,7 @@ import * as readline from "readline";
 import type { Protocol } from "devtools-protocol";
 import { version as VERSION } from "../package.json";
 import { resolveWsTarget } from "./resolve-ws";
+import { NodeHtmlMarkdown } from "node-html-markdown";
 
 const program = new Command();
 
@@ -1231,6 +1232,11 @@ async function executeCommand(
               .deepLocator(resolveSelector(selector!))
               .isChecked(),
           };
+        case "markdown": {
+          const target = selector ? resolveSelector(selector) : "body";
+          const html = await page!.deepLocator(target).innerHtml();
+          return { markdown: NodeHtmlMarkdown.translate(html) };
+        }
         default:
           throw new Error(`Unknown get type: ${what}`);
       }
@@ -2465,7 +2471,7 @@ program
 program
   .command("get <what> [selector]")
   .description(
-    "Get page info: url, title, text, html, value, box, visible, checked",
+    "Get page info: url, title, text, html, markdown, value, box, visible, checked",
   )
   .action(async (what: string, selector?: string) => {
     const opts = program.opts<GlobalOpts>();