From f946eea4b32bb93ba9611a538f3a405bae4b5e23 Mon Sep 17 00:00:00 2001
From: "mintlify-development[bot]"
 <109878554+mintlify-development[bot]@users.noreply.github.com>
Date: Sat, 23 May 2026 00:13:50 +0000
Subject: [PATCH] docs: note custom heading IDs preserve casing

---
 create/text.mdx       | 10 ++++++++++
 es/create/text.mdx    | 10 ++++++++++
 es/guides/linking.mdx |  4 +++-
 fr/create/text.mdx    | 10 ++++++++++
 fr/guides/linking.mdx |  4 +++-
 guides/linking.mdx    |  4 +++-
 zh/create/text.mdx    | 10 ++++++++++
 zh/guides/linking.mdx |  4 +++-
 8 files changed, 52 insertions(+), 4 deletions(-)

diff --git a/create/text.mdx b/create/text.mdx
index cb5f71461..fa921f0d2 100644
--- a/create/text.mdx
+++ b/create/text.mdx
@@ -36,6 +36,16 @@ The custom ID replaces the auto-generated anchor, so you can link to the heading
 
 This is useful when you want stable anchor links that don't change if you update the heading text, or when you need shorter, more memorable anchors.
 
+Custom IDs preserve the casing and separators you write, so `camelCase`, `snake_case`, and `kebab-case` are all kept as-is. This makes it easier to migrate anchor links from other documentation tools without breaking inbound links.
+
+```mdx
+## Connection settings {#camelCaseId}
+## Query options {#snake_case_id}
+## Advanced usage {#kebab-case-id}
+```
+
+Auto-generated IDs (headings without `{#id}`) are unchanged—they continue to be lowercased and hyphenated.
+
 ### Disabling anchor links
 
 By default, headers include clickable anchor links that allow users to link directly to specific sections. You can disable these anchor links using the `noAnchor` prop in HTML or React headers.
diff --git a/es/create/text.mdx b/es/create/text.mdx
index fa9cf6720..f69ea2c1a 100644
--- a/es/create/text.mdx
+++ b/es/create/text.mdx
@@ -42,6 +42,16 @@ El ID personalizado reemplaza al anclaje generado automáticamente, por lo que p
 
 Esto es útil cuando deseas enlaces de anclaje estables que no cambien al actualizar el texto del encabezado, o cuando necesitas anclajes más cortos y fáciles de recordar.
 
+Los IDs personalizados preservan las mayúsculas y los separadores que escribas, por lo que `camelCase`, `snake_case` y `kebab-case` se conservan tal cual. Esto facilita migrar enlaces de anclaje desde otras herramientas de documentación sin romper los enlaces entrantes.
+
+```mdx
+## Connection settings {#camelCaseId}
+## Query options {#snake_case_id}
+## Advanced usage {#kebab-case-id}
+```
+
+Los IDs generados automáticamente (encabezados sin `{#id}`) no cambian: siguen convirtiéndose a minúsculas y con guiones.
+
 <div id="disabling-anchor-links">
   ### Desactivar enlaces de anclaje
 </div>
diff --git a/es/guides/linking.mdx b/es/guides/linking.mdx
index f8c2b3ea1..f86ceda8c 100644
--- a/es/guides/linking.mdx
+++ b/es/guides/linking.mdx
@@ -93,7 +93,9 @@ Sobrescribe el anclaje generado automáticamente para cualquier encabezado añad
 ## Configuration options {#config}
 ```
 
-Este encabezado es accesible en `#config` en lugar de `#configuration-options`. Los IDs personalizados mantienen los enlaces de anclaje estables cuando actualizas el texto del encabezado—útil para encabezados a los que enlazas frecuentemente. Consulta [Formatear texto](/es/create/text#custom-heading-ids) para más detalles.
+Este encabezado es accesible en `#config` en lugar de `#configuration-options`. Los IDs personalizados mantienen los enlaces de anclaje estables cuando actualizas el texto del encabezado—útil para encabezados a los que enlazas frecuentemente.
+
+Los IDs personalizados preservan las mayúsculas, por lo que `{#camelCaseId}`, `{#snake_case_id}` y `{#kebab-case-id}` se conservan tal cual los escribes. Esto es útil al migrar enlaces de anclaje desde otras plataformas de documentación. Consulta [Formatear texto](/es/create/text#custom-heading-ids) para más detalles.
 
 <div id="deep-links">
 ## Enlaces profundos
diff --git a/fr/create/text.mdx b/fr/create/text.mdx
index b4079bc12..c3a61e2d0 100644
--- a/fr/create/text.mdx
+++ b/fr/create/text.mdx
@@ -42,6 +42,16 @@ L'ID personnalisé remplace l'ancrage généré automatiquement. Vous pouvez ain
 
 Cela est utile lorsque vous souhaitez des liens d'ancrage stables qui ne changent pas si vous modifiez le texte du titre, ou lorsque vous avez besoin d'ancrages plus courts et plus faciles à retenir.
 
+Les IDs personnalisés préservent la casse et les séparateurs que vous écrivez, donc `camelCase`, `snake_case` et `kebab-case` sont conservés tels quels. Cela facilite la migration des liens d'ancrage depuis d'autres outils de documentation sans casser les liens entrants.
+
+```mdx
+## Connection settings {#camelCaseId}
+## Query options {#snake_case_id}
+## Advanced usage {#kebab-case-id}
+```
+
+Les IDs générés automatiquement (titres sans `{#id}`) restent inchangés : ils continuent d'être mis en minuscules et séparés par des tirets.
+
 <div id="disabling-anchor-links">
   ### Désactivation des liens d’ancrage
 </div>
diff --git a/fr/guides/linking.mdx b/fr/guides/linking.mdx
index 0c9f7ae47..0917ac68a 100644
--- a/fr/guides/linking.mdx
+++ b/fr/guides/linking.mdx
@@ -93,7 +93,9 @@ Remplacez l'ancrage généré automatiquement pour n'importe quel titre en ajout
 ## Configuration options {#config}
 ```
 
-Ce titre est accessible à `#config` au lieu de `#configuration-options`. Les IDs personnalisés maintiennent les liens d'ancrage stables lorsque vous mettez à jour le texte du titre—utile pour les titres vers lesquels vous liez fréquemment. Consultez [Formater le texte](/fr/create/text#custom-heading-ids) pour plus de détails.
+Ce titre est accessible à `#config` au lieu de `#configuration-options`. Les IDs personnalisés maintiennent les liens d'ancrage stables lorsque vous mettez à jour le texte du titre—utile pour les titres vers lesquels vous liez fréquemment.
+
+Les IDs personnalisés préservent la casse, donc `{#camelCaseId}`, `{#snake_case_id}` et `{#kebab-case-id}` sont conservés tels que vous les écrivez. Cela est utile lors de la migration de liens d'ancrage depuis d'autres plateformes de documentation. Consultez [Formater le texte](/fr/create/text#custom-heading-ids) pour plus de détails.
 
 <div id="deep-links">
 ## Liens profonds
diff --git a/guides/linking.mdx b/guides/linking.mdx
index d50b3782a..74309a47a 100644
--- a/guides/linking.mdx
+++ b/guides/linking.mdx
@@ -81,7 +81,9 @@ Override the auto-generated anchor for any heading by appending `{#custom-id}` t
 ## Configuration options {#config}
 ```
 
-This heading is reachable at `#config` instead of `#configuration-options`. Custom IDs keep anchor links stable when you update heading text—useful for headings you link to frequently. See [Format text](/create/text#custom-heading-ids) for more details.
+This heading is reachable at `#config` instead of `#configuration-options`. Custom IDs keep anchor links stable when you update heading text—useful for headings you link to frequently.
+
+Custom IDs preserve casing, so `{#camelCaseId}`, `{#snake_case_id}`, and `{#kebab-case-id}` are kept as-written. This is helpful when migrating anchor links from other documentation platforms. See [Format text](/create/text#custom-heading-ids) for more details.
 
 ## Deep links
 
diff --git a/zh/create/text.mdx b/zh/create/text.mdx
index f74d44fdc..17d951a5d 100644
--- a/zh/create/text.mdx
+++ b/zh/create/text.mdx
@@ -42,6 +42,16 @@ keywords: ["Markdown 格式", "文本样式", "标题", "锚点链接", "custom
 
 当你希望锚点链接保持稳定、不因标题文本更新而变化时，或者需要更短、更易记的锚点时，此功能非常有用。
 
+自定义 ID 会保留你所写的大小写和分隔符，因此 `camelCase`、`snake_case` 和 `kebab-case` 都会按原样保留。这便于从其他文档工具迁移锚点链接，而不会破坏入站链接。
+
+```mdx
+## Connection settings {#camelCaseId}
+## Query options {#snake_case_id}
+## Advanced usage {#kebab-case-id}
+```
+
+自动生成的 ID（没有 `{#id}` 的标题）保持不变——它们仍会被转换为小写并使用连字符。
+
 <div id="disabling-anchor-links">
   ### 禁用锚点链接
 </div>
diff --git a/zh/guides/linking.mdx b/zh/guides/linking.mdx
index 1fd700a07..603fba1a5 100644
--- a/zh/guides/linking.mdx
+++ b/zh/guides/linking.mdx
@@ -93,7 +93,9 @@ Mintlify 通过将标题文本转换为小写、用连字符替换空格并删
 ## Configuration options {#config}
 ```
 
-此标题可通过 `#config` 访问，而不是 `#configuration-options`。自定义 ID 在你更新标题文本时保持锚点链接稳定——这对你经常链接到的标题很有用。详情请参阅[格式化文本](/zh/create/text#custom-heading-ids)。
+此标题可通过 `#config` 访问，而不是 `#configuration-options`。自定义 ID 在你更新标题文本时保持锚点链接稳定——这对你经常链接到的标题很有用。
+
+自定义 ID 会保留大小写，因此 `{#camelCaseId}`、`{#snake_case_id}` 和 `{#kebab-case-id}` 都会按你所写的样式保留。这在从其他文档平台迁移锚点链接时很有用。详情请参阅[格式化文本](/zh/create/text#custom-heading-ids)。
 
 <div id="deep-links">
 ## 深层链接