docs: escape regex

diff --git a/packages/docs/guide/essentials/route-matching-syntax.md b/packages/docs/guide/essentials/route-matching-syntax.md
index b18244983067ff4cb350ea070eb4e9563dcd2064..e1455840a483a18728d5504f90e3c95e6263b8c2 100644 (file)
--- a/packages/docs/guide/essentials/route-matching-syntax.md
+++ b/packages/docs/guide/essentials/route-matching-syntax.md
@@ -41,6 +41,15 @@ Now, going to `/25` will match `/:orderId` while going to anything else will mat
 Make sure to **escape backslashes (`\`)** like we did with `\d` (becomes `\\d`) to actually pass the backslash character in a string in JavaScript.
 :::
 
+Since the closing parentheses `)` is used to mark the end of a custom regex, you must escape it inside of the regexp (e.g. nested groups):
+
+```js
+const routes = [
+  // note the escaped closing parentheses of the group within the regexp
+  { path: '/:custom(somethnig-(nested|other\\))' },
+]
+```
+
 ## Repeatable params
 
 If you need to match routes with multiple sections like `/first/second/third`, you should mark a param as repeatable with `*` (0 or more) and `+` (1 or more):