chore: generate markdown docs from jsdocs

Author: remix-run-bot

docs/api/hooks/useSearchParams.md

@@ -59,7 +59,8 @@ setSearchParams([["tab", "1"]]);
 setSearchParams(new URLSearchParams("?tab=1"));
 ```
 
-It also supports a function callback like React's [`setState`](https://react.dev/reference/react/useState#setstate):
+It also supports a function callback like React's
+[`setState`](https://react.dev/reference/react/useState#setstate):
 
 ```tsx
 setSearchParams((searchParams) => {
@@ -68,6 +69,12 @@ setSearchParams((searchParams) => {
 });
 ```
 
+<docs-warning>The function callback version of `setSearchParams` does not support
+the [queueing](https://react.dev/reference/react/useState#setstate-parameters)
+logic that React's `setState` implements.  Multiple calls to `setSearchParams`
+in the same tick will not build on the prior value.  If you need this behavior,
+you can use `setState` manually.</docs-warning>
+
 ### Notes
 
 Note that `searchParams` is a stable reference, so you can reliably use it