diff --git a/create/text.mdx b/create/text.mdx
index 04d4dba9bd..91ca9af29e 100644
--- a/create/text.mdx
+++ b/create/text.mdx
@@ -267,6 +267,27 @@ Use MDX-style comments to add notes, reminders, or to-dos in your source files.
HTML-style `` comments are not supported in MDX. Always use `{/* ... */}`.
+## Escape special characters
+
+MDX treats `{` and `}` as the start and end of JSX expressions, and `<` as the start of a JSX tag. When you want these characters to render as literal text, escape them so MDX does not try to parse them.
+
+| Character | How to escape |
+| :--- | :--- |
+| `{` and `}` | Wrap the character in backticks (`` `{` ``), use the HTML entity (`{` for `{`, `}` for `}`), or write it inside a JSX expression as a string (`{'{'}`). |
+| `<` | Wrap in backticks (`` `<` ``), use the HTML entity `<`, or write `{'<'}`. |
+| `` ` `` | Use a backslash (`` \` ``) or wrap a longer span in double backticks (`` ``code with ` inside`` ``). |
+| `\` | Use a double backslash (`\\`). |
+
+```mdx Escape examples
+Use the `{variable}` syntax to interpolate values.
+
+The placeholder {name} renders as literal curly braces.
+
+In JSX, write {'{ key: value }'} to display a literal object.
+```
+
+Inside fenced code blocks (```` ``` ````), MDX does not parse curly braces, so you can write `{variable}` directly without escaping. Escaping is only required in regular prose and inside JSX attributes.
+
## Best practices
### Content organization
diff --git a/es/create/text.mdx b/es/create/text.mdx
index bdc83fd62b..0100dc5a6b 100644
--- a/es/create/text.mdx
+++ b/es/create/text.mdx
@@ -314,6 +314,29 @@ Usa comentarios al estilo MDX para añadir notas, recordatorios o tareas pendien
Los comentarios al estilo HTML `` no son compatibles con MDX. Usa siempre `{/* ... */}`.
+
+ ## Escapar caracteres especiales
+
+
+MDX trata `{` y `}` como el inicio y el final de una expresión JSX, y `<` como el inicio de una etiqueta JSX. Cuando quieras que estos caracteres se muestren como texto literal, escápalos para que MDX no intente analizarlos.
+
+| Carácter | Cómo escaparlo |
+| :--- | :--- |
+| `{` y `}` | Envuelve el carácter en comillas invertidas (`` `{` ``), usa la entidad HTML (`{` para `{`, `}` para `}`) o escríbelo dentro de una expresión JSX como una cadena (`{'{'}`). |
+| `<` | Envuelve en comillas invertidas (`` `<` ``), usa la entidad HTML `<` o escribe `{'<'}`. |
+| `` ` `` | Usa una barra invertida (`` \` ``) o envuelve un fragmento más largo en comillas invertidas dobles (`` ``código con ` dentro`` ``). |
+| `\` | Usa una doble barra invertida (`\\`). |
+
+```mdx Ejemplos de escape
+Usa la sintaxis `{variable}` para interpolar valores.
+
+El marcador {name} se muestra como llaves literales.
+
+En JSX, escribe {'{ key: value }'} para mostrar un objeto literal.
+```
+
+Dentro de los bloques de código delimitados (```` ``` ````), MDX no analiza las llaves, por lo que puedes escribir `{variable}` directamente sin escapar. El escape solo es necesario en la prosa normal y dentro de los atributos JSX.
+
## Buenas prácticas
diff --git a/es/organize/navigation.mdx b/es/organize/navigation.mdx
index e319bc69cc..1269e2507b 100644
--- a/es/organize/navigation.mdx
+++ b/es/organize/navigation.mdx
@@ -37,6 +37,39 @@ En el objeto `navigation`, `pages` es un array donde cada entrada debe hacer ref
}
```
+
+ ### Combina páginas independientes con grupos
+
+
+El objeto `navigation` de nivel superior admite un único patrón principal (por ejemplo, `pages` o `groups`), pero el array `pages` de un grupo puede combinar rutas de páginas como cadenas con objetos de grupos anidados. Usa este patrón para colocar una página independiente, como una página de resumen o de bienvenida, encima de otros grupos en la barra lateral.
+
+Envuelve tu navegación en un único grupo de nivel superior y lista la página independiente antes de los grupos anidados:
+
+```json
+{
+ "navigation": {
+ "groups": [
+ {
+ "group": "Documentation",
+ "pages": [
+ "overview",
+ {
+ "group": "Get started",
+ "pages": ["quickstart", "installation"]
+ },
+ {
+ "group": "Guides",
+ "pages": ["guides/authentication", "guides/deployment"]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+En este ejemplo, `overview` aparece como un enlace independiente en la parte superior de la barra lateral, seguido por los grupos `Get started` y `Guides`. También puedes usar la propiedad `root` en un grupo para designar una página de resumen para ese grupo. Consulta [Página raíz](/es/organize/navigation#root-page).
+
## Grupos
diff --git a/fr/create/text.mdx b/fr/create/text.mdx
index 94cd06b191..872ce59d7d 100644
--- a/fr/create/text.mdx
+++ b/fr/create/text.mdx
@@ -314,6 +314,29 @@ Utilisez des commentaires de style MDX pour ajouter des notes, des rappels ou de
Les commentaires de style HTML `` ne sont pas pris en charge en MDX. Utilisez toujours `{/* ... */}`.
+
+ ## Échapper les caractères spéciaux
+
+
+MDX interprète `{` et `}` comme le début et la fin d'une expression JSX, et `<` comme le début d'une balise JSX. Lorsque vous souhaitez que ces caractères s'affichent comme du texte littéral, échappez-les pour que MDX n'essaie pas de les analyser.
+
+| Caractère | Comment l'échapper |
+| :--- | :--- |
+| `{` et `}` | Encadrez le caractère par des accents graves (`` `{` ``), utilisez l'entité HTML (`{` pour `{`, `}` pour `}`) ou écrivez-le dans une expression JSX sous forme de chaîne (`{'{'}`). |
+| `<` | Encadrez par des accents graves (`` `<` ``), utilisez l'entité HTML `<`, ou écrivez `{'<'}`. |
+| `` ` `` | Utilisez une barre oblique inverse (`` \` ``) ou encadrez une plus longue portion par des doubles accents graves (`` ``code avec ` à l'intérieur`` ``). |
+| `\` | Utilisez une double barre oblique inverse (`\\`). |
+
+```mdx Exemples d'échappement
+Utilisez la syntaxe `{variable}` pour interpoler des valeurs.
+
+L'emplacement {name} s'affiche comme des accolades littérales.
+
+En JSX, écrivez {'{ key: value }'} pour afficher un objet littéral.
+```
+
+Dans les blocs de code délimités (```` ``` ````), MDX n'analyse pas les accolades, vous pouvez donc écrire `{variable}` directement sans échappement. L'échappement n'est requis que dans le texte courant et à l'intérieur des attributs JSX.
+
## Bonnes pratiques
diff --git a/fr/organize/navigation.mdx b/fr/organize/navigation.mdx
index db4b2a6577..fb30d6eb05 100644
--- a/fr/organize/navigation.mdx
+++ b/fr/organize/navigation.mdx
@@ -37,6 +37,39 @@ Dans l'objet `navigation`, `pages` est un tableau dont chaque entrée doit r
}
```
+
+ ### Combiner des pages autonomes avec des groupes
+
+
+L'objet `navigation` à la racine accepte un seul modèle principal (par exemple, `pages` ou `groups`), mais le tableau `pages` d'un groupe peut combiner des chemins de pages sous forme de chaînes avec des objets de groupes imbriqués. Utilisez ce pattern pour placer une page autonome, telle qu'une page d'aperçu ou de bienvenue, au-dessus des autres groupes dans la barre latérale.
+
+Encapsulez votre navigation dans un seul groupe de premier niveau et listez la page autonome avant les groupes imbriqués :
+
+```json
+{
+ "navigation": {
+ "groups": [
+ {
+ "group": "Documentation",
+ "pages": [
+ "overview",
+ {
+ "group": "Get started",
+ "pages": ["quickstart", "installation"]
+ },
+ {
+ "group": "Guides",
+ "pages": ["guides/authentication", "guides/deployment"]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+Dans cet exemple, `overview` apparaît comme un lien autonome en haut de la barre latérale, suivi des groupes `Get started` et `Guides`. Vous pouvez aussi utiliser la propriété `root` sur un groupe pour désigner une page d'aperçu pour ce groupe. Voir [Page racine](/fr/organize/navigation#root-page).
+
## Groupes
diff --git a/organize/navigation.mdx b/organize/navigation.mdx
index 30694bf038..0d1e5b7400 100644
--- a/organize/navigation.mdx
+++ b/organize/navigation.mdx
@@ -43,6 +43,37 @@ In the `navigation` object, `pages` is an array where each entry must reference
}
```
+### Mix standalone pages with groups
+
+The top-level `navigation` object accepts one primary pattern (for example, `pages` or `groups`), but a group's `pages` array can mix string page paths with nested group objects. Use this to place a standalone page, such as an overview or welcome page, above other groups in the sidebar.
+
+Wrap your navigation in a single top-level group and list the standalone page before the nested groups:
+
+```json
+{
+ "navigation": {
+ "groups": [
+ {
+ "group": "Documentation",
+ "pages": [
+ "overview",
+ {
+ "group": "Get started",
+ "pages": ["quickstart", "installation"]
+ },
+ {
+ "group": "Guides",
+ "pages": ["guides/authentication", "guides/deployment"]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+In this example, `overview` appears as a standalone link at the top of the sidebar, followed by the `Get started` and `Guides` groups. You can also use the `root` property on a group to designate an overview page for that group. See [Root page](#root-page).
+
## Groups
Use groups to organize your sidebar navigation into sections. You can nest groups within each other, label them with tags, and style them with icons.