mintlify · ethanpalm · Aug 31, 2026 · Aug 29, 2026 · Aug 29, 2026 · Aug 31, 2026
diff --git a/ai/bring-your-own-model.mdx b/ai/bring-your-own-model.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Bring your own model"
-description: "Use your own LLM provider API key and choose the model that powers the Mintlify assistant and agent."
+description: "Use your own LLM provider API key and choose the model that powers the Mintlify assistant, agent, and automations on Enterprise plans."
 keywords: ["BYOK", "key", "OpenRouter", "Anthropic", "OpenAI", "LLM", "API key", "credits"]
 ---
 

diff --git a/components/mdx.mdx b/components/mdx.mdx
@@ -48,7 +48,7 @@ You can also use `<MDX>` at the top level of a page to group a Markdown section
 Leave a blank line after the opening tag in block form so the content parses as block-level Markdown. Inside expressions, `<MDX>` strips the common leading indentation from its content, so you can indent it to match the surrounding code.
 
 <Note>
-  Headings inside `<MDX>` do not appear in the page's table of contents.
+  Headings inside `<MDX>` appear in the page's table of contents. This includes headings in branches that never render, such as the inactive side of a conditional.
 </Note>
 
 ## Limits

diff --git a/create/list-table.mdx b/create/list-table.mdx
@@ -58,6 +58,18 @@
 - Third item
 ```
 
+### Task list
+
+To create a task list, add `[ ]` for an unchecked checkbox or `[x]` for a checked checkbox after unordered list markers.
+
+- [x] Completed item
+- [ ] Incomplete item
+
+```mdx
+- [x] Completed item
+- [ ] Incomplete item
+```
+
 ## Tables
 
 Tables follow the official [Markdown syntax](https://www.markdownguide.org/extended-syntax/#tables).
@@ -80,7 +92,7 @@

 ### Escape pipe characters

 To include a literal pipe character (`|`) in a table cell, prefix it with a backslash (`\|`). Escape pipe characters even when they appear inside inline code. Otherwise, the pipe is treated as a column separator and can cause parsing errors during preview or validation.

 | Value         | Description                       |
 | ------------- | --------------------------------- |

diff --git a/editor/settings.mdx b/editor/settings.mdx
@@ -12,6 +12,15 @@
 - **Chat**: Persistent instructions for the editor's AI agent.
 - **Danger zone**: Actions that can't be undone.
 
+## Appearance
+
+Appearance settings are personal preferences. They change the editor only for you and don't affect teammates or your published site.
+
+- **Fit editor to full width**: Stretch the editing canvas edge-to-edge instead of the default 768px column.
+- **Show breadcrumbs**: Show the page's location in the site navigation above the editing canvas.
+- **Open live preview in new tab**: Open the rendered page in a new browser tab when you preview, instead of the split-pane preview.
+- **Show all files**: Show every file in the sidebar, including dotfiles, code, PDFs, and other files hidden by default. You can also press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows) to toggle.
+
 ## PR instructions
 
 PR instructions guide the AI when it generates a pull request title and description. They apply whenever the editor opens a pull request on your behalf, including from **Create pull request** and **Merge and publish** flows.
@@ -31,7 +40,7 @@
 using its relative path.
 ```

 Instructions are limited to 20,000 characters.

 ## Main branch autocommits

@@ -64,7 +73,7 @@
 - **Edit with AI** actions on a selection, such as rewrite, expand, or fix.
 - **Agent sessions** started from the editor.

 Each teammate maintains their own instructions, scoped to their user account. Instructions are limited to 20,000 characters.

 Add AI instructions when you find yourself repeating the same guidance in prompts, for example:


diff --git a/es/ai/bring-your-own-model.mdx b/es/ai/bring-your-own-model.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Usa tu propio modelo"
-description: "Usa tu propia clave de API de un proveedor de LLM y elige el modelo que impulsa el assistant y el agente de Mintlify."
+description: "Usa tu propia clave de API de un proveedor de LLM y elige el modelo que impulsa el assistant, el agente y las automatizaciones de Mintlify en los planes Enterprise."
 keywords: ["BYOK", "clave", "OpenRouter", "Anthropic", "OpenAI", "LLM", "clave de API", "créditos"]
 ---
 
@@ -46,7 +46,7 @@ Mintlify almacena tu clave cifrada y nunca vuelve a mostrarla después de que la
   ## Cómo funcionan los créditos
 </div>
 
-Los productos de IA de Mintlify siguen consumiendo [créditos](/es/credits) cuando usas tu propio modelo, pero a una tarifa reducida para el deployment que configuraste.
+Los productos de IA de Mintlify siguen consumiendo [créditos](/es/credits) cuando usas tu propio modelo, pero a la mitad de la tarifa estándar para el deployment que configuraste.
 
 Los créditos se agrupan a nivel de organización, por lo que la tarifa reducida se aplica solo al uso de IA en los deployments donde usas tu propio modelo. Los demás deployments consumen del mismo saldo a la tarifa estándar.
 

diff --git a/es/components/mdx.mdx b/es/components/mdx.mdx
@@ -52,7 +52,7 @@ También puedes usar `<MDX>` en el nivel superior de una página para agrupar un
 Deja una línea en blanco después de la etiqueta de apertura en la forma de bloque para que el contenido se analice como Markdown a nivel de bloque. Dentro de expresiones, `<MDX>` elimina la sangría inicial común de su contenido, por lo que puedes sangrarlo para que coincida con el código circundante.
 
 <Note>
-  Los encabezados dentro de `<MDX>` no aparecen en la tabla de contenido de la página.
+  Los encabezados dentro de `<MDX>` se fusionan en la tabla de contenido de la página en el orden del documento. Esto incluye los encabezados de ramas que nunca se renderizan, como el lado inactivo de un condicional.
 </Note>
 
 <div id="limits">

diff --git a/es/create/list-table.mdx b/es/create/list-table.mdx
@@ -69,6 +69,21 @@ Sangra los elementos de la lista para anidarlos.
 ```
 
 
+<div id="task-list">
+  ### Lista de tareas
+</div>
+
+Para crear una lista de tareas, agrega `[ ]` para una casilla sin marcar o `[x]` para una casilla marcada después de los marcadores de lista sin orden.
+
+- [x] Elemento completado
+- [ ] Elemento incompleto
+
+```mdx
+- [x] Elemento completado
+- [ ] Elemento incompleto
+```
+
+
 <div id="tables">
   ## Tablas
 </div>

diff --git a/es/credits.mdx b/es/credits.mdx
@@ -146,7 +146,7 @@ Las auditorías SEO, las verificaciones de estilo de redacción y la detección
   ### Usa tu propio modelo
 </div>
 
-En los planes Enterprise, puedes proporcionar tu propia clave de API de un proveedor de LLM y elegir el modelo detrás del assistant, el agente y las automatizaciones. El uso se mide a una tarifa de créditos reducida, y tu proveedor te factura directamente por la inferencia. Los modelos se configuran por deployment, no para toda la organización. Consulta [Usa tu propio modelo](/es/ai/bring-your-own-model) para más información.
+En los planes Enterprise, puedes proporcionar tu propia clave de API de un proveedor de LLM y elegir el modelo detrás del assistant, el agente y las automatizaciones. El uso se mide a la mitad de la tarifa de créditos estándar, y tu proveedor te factura directamente por la inferencia. Los modelos se configuran por deployment, no para toda la organización. Consulta [Usa tu propio modelo](/es/ai/bring-your-own-model) para más información.
 
 <div id="find-whats-consuming-your-credits">
   ### Descubre qué está consumiendo tus créditos

diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
@@ -18,12 +18,12 @@ La [página de configuración](https://app.mintlify.com/settings/deployment/edit
 
 </div>
 
-Las preferencias de apariencia están vinculadas a su cuenta de usuario y se aplican en cuanto las activa.
+Los ajustes de apariencia son preferencias personales. Cambian el editor solo para usted y no afectan a sus compañeros de equipo ni a su sitio publicado.
 
-- **Fit editor to full width**: Extiende el lienzo de edición de borde a borde en lugar de usar la columna de ancho fijo predeterminada.
+- **Fit editor to full width**: Extiende el lienzo de edición de borde a borde en lugar de usar la columna predeterminada de 768px.
 - **Show breadcrumbs**: Muestra la ubicación de la página en la navegación del sitio encima del lienzo de edición.
-- **Open live preview in new tab**: Abre la página representada en una pestaña nueva del navegador al previsualizar. Déjelo desactivado para editar la configuración del sitio desde dentro de la [vista previa en vivo](/es/editor/review#live-preview).
-- **Show all files**: Muestra todos los archivos de la barra lateral, incluidos los dotfiles, el código, los PDF y otros archivos que el árbol de navegación oculta de forma predeterminada.
+- **Open live preview in new tab**: Abre la página representada en una pestaña nueva del navegador al previsualizar, en lugar de la vista previa en panel dividido.
+- **Show all files**: Muestra todos los archivos en la barra lateral, incluidos los dotfiles, el código, los PDF y otros archivos ocultos de forma predeterminada. También puede pulsar <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows) para alternarlo.
 
 <div id="pr-instructions">
 

diff --git a/es/reference/glossary.mdx b/es/reference/glossary.mdx
@@ -28,6 +28,12 @@ Una herramienta de IA para quienes mantienen la documentación que investiga, es
 
 Un enlace de navegación persistente de nivel superior que apunta a un destino interno o externo. Los anchors son uno de los patrones principales de navegación disponibles en `docs.json`. Consulta [Anchors](/es/organize/navigation#anchors).
 
+<div id="api-playground">
+### API playground
+</div>
+
+Un entorno interactivo en las páginas de endpoints donde los lectores crean, envían e inspeccionan solicitudes de API reales sin salir de tu documentación. Mintlify genera el playground a partir de un documento [OpenAPI](#openapi). Consulta [Información general del API playground](/es/api-playground/overview).
+
 <div id="assistant">
 ### Assistant
 </div>

diff --git a/fr/ai/bring-your-own-model.mdx b/fr/ai/bring-your-own-model.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Utiliser votre propre modèle"
-description: "Utilisez votre propre clé d'API de fournisseur LLM et choisissez le modèle qui alimente l'assistant et l'agent Mintlify."
+description: "Utilisez votre propre clé d'API de fournisseur LLM et choisissez le modèle qui alimente l'assistant, l'agent et les automatisations Mintlify sur les forfaits Enterprise."
 keywords: ["BYOK", "clé", "OpenRouter", "Anthropic", "OpenAI", "LLM", "clé d'API", "crédits"]
 ---
 
@@ -46,7 +46,7 @@ Mintlify stocke votre clé de manière chiffrée et ne l'affiche plus jamais apr
   ## Fonctionnement des crédits
 </div>
 
-Les produits d'IA de Mintlify consomment toujours des [crédits](/fr/credits) lorsque vous utilisez votre propre modèle, mais à un tarif réduit pour le déploiement que vous avez configuré.
+Les produits d'IA de Mintlify consomment toujours des [crédits](/fr/credits) lorsque vous utilisez votre propre modèle, mais à la moitié du tarif standard pour le déploiement que vous avez configuré.
 
 Les crédits sont mutualisés au niveau de l'organisation, donc le tarif réduit s'applique uniquement à l'utilisation de l'IA sur les déploiements où vous utilisez votre propre modèle. Les autres déploiements puisent dans le même solde au tarif standard.
 

diff --git a/fr/components/mdx.mdx b/fr/components/mdx.mdx
@@ -52,7 +52,7 @@ Vous pouvez également utiliser `<MDX>` au niveau supérieur d'une page pour reg
 Laissez une ligne vide après la balise ouvrante dans la forme bloc pour que le contenu soit analysé comme du Markdown au niveau bloc. Dans les expressions, `<MDX>` supprime l'indentation initiale commune de son contenu, vous pouvez donc l'indenter pour l'aligner sur le code environnant.
 
 <Note>
-  Les titres à l'intérieur de `<MDX>` n'apparaissent pas dans la table des matières de la page.
+  Les titres à l'intérieur de `<MDX>` sont fusionnés dans la table des matières de la page dans l'ordre du document. Cela inclut les titres des branches qui ne s'affichent jamais, comme le côté inactif d'une condition.
 </Note>
 
 <div id="limits">

diff --git a/fr/create/list-table.mdx b/fr/create/list-table.mdx
@@ -69,6 +69,21 @@ Indentez les éléments de la liste pour les imbriquer.
 ```
 
 
+<div id="task-list">
+  ### Liste de tâches
+</div>
+
+Pour créer une liste de tâches, ajoutez `[ ]` pour une case à cocher décochée ou `[x]` pour une case à cocher cochée après les marqueurs de liste à puces.
+
+- [x] Élément terminé
+- [ ] Élément non terminé
+
+```mdx
+- [x] Élément terminé
+- [ ] Élément non terminé
+```
+
+
 <div id="tables">
   ## Tables
 </div>

diff --git a/fr/credits.mdx b/fr/credits.mdx
@@ -146,7 +146,7 @@ Les audits SEO, les vérifications du style rédactionnel et la détection des l
   ### Utiliser votre propre modèle
 </div>
 
-Avec les forfaits Enterprise, vous pouvez fournir votre propre clé d'API de fournisseur LLM et choisir le modèle derrière l'assistant, l'agent et les automatisations. L'utilisation est mesurée à un tarif de crédits réduit, et votre fournisseur vous facture directement l'inférence. Vous configurez les modèles par déploiement, pas pour toute l'organisation. Consultez [Utiliser votre propre modèle](/fr/ai/bring-your-own-model) pour plus d'informations.
+Avec les forfaits Enterprise, vous pouvez fournir votre propre clé d'API de fournisseur LLM et choisir le modèle derrière l'assistant, l'agent et les automatisations. L'utilisation est mesurée à la moitié du tarif de crédits standard, et votre fournisseur vous facture directement l'inférence. Vous configurez les modèles par déploiement, pas pour toute l'organisation. Consultez [Utiliser votre propre modèle](/fr/ai/bring-your-own-model) pour plus d'informations.
 
 <div id="find-whats-consuming-your-credits">
   ### Identifier ce qui consomme vos crédits

diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
@@ -18,12 +18,12 @@ La [page de paramètres](https://app.mintlify.com/settings/deployment/editor) de
 
 </div>
 
-Les préférences d'apparence sont liées à votre compte utilisateur et prennent effet dès que vous les activez.
+Les paramètres d'apparence sont des préférences personnelles. Ils ne modifient l'éditeur que pour vous et n'affectent ni vos coéquipiers ni votre site publié.
 
-- **Fit editor to full width** : Étend la zone d'édition d'un bord à l'autre au lieu d'utiliser la colonne de largeur fixe par défaut.
+- **Fit editor to full width** : Étend la zone d'édition d'un bord à l'autre au lieu de la colonne de 768px par défaut.
 - **Show breadcrumbs** : Affiche l'emplacement de la page dans la navigation du site au-dessus de la zone d'édition.
-- **Open live preview in new tab** : Ouvre la page rendue dans un nouvel onglet du navigateur lors de la prévisualisation. Laissez cette option désactivée pour modifier les paramètres du site depuis l'[aperçu en direct](/fr/editor/review#live-preview).
-- **Show all files** : Affiche tous les fichiers dans la barre latérale, y compris les dotfiles, le code, les PDF et les autres fichiers que l'arborescence de navigation masque par défaut.
+- **Open live preview in new tab** : Ouvre la page rendue dans un nouvel onglet du navigateur lors de la prévisualisation, au lieu de l'aperçu en volet partagé.
+- **Show all files** : Affiche tous les fichiers dans la barre latérale, y compris les dotfiles, le code, les PDF et les autres fichiers masqués par défaut. Vous pouvez aussi appuyer sur <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows) pour basculer l'affichage.
 
 <div id="pr-instructions">
 

diff --git a/fr/reference/glossary.mdx b/fr/reference/glossary.mdx
@@ -28,6 +28,12 @@ Un outil d'IA destiné aux mainteneurs de documentation qui recherche, rédige,
 
 Un lien de navigation persistant de premier niveau vers une destination interne ou externe. Les ancres constituent l'un des principaux schémas de navigation disponibles dans `docs.json`. Consultez [Ancres](/fr/organize/navigation#anchors).
 
+<div id="api-playground">
+### API playground
+</div>
+
+Un environnement interactif sur les pages d'endpoints où les lecteurs élaborent, envoient et inspectent de véritables requêtes d'API sans quitter votre documentation. Mintlify génère le playground à partir d'un document [OpenAPI](#openapi). Consultez [Vue d'ensemble du playground API](/fr/api-playground/overview).
+
 <div id="assistant">
 ### Assistant
 </div>

diff --git a/reference/glossary.mdx b/reference/glossary.mdx
@@ -20,6 +20,10 @@
 
 A persistent top-level navigation link to an internal or external destination. Anchors are one of the primary navigation patterns available in `docs.json`. See [Anchors](/organize/navigation#anchors).
 
+### API playground
+
+An interactive environment on endpoint pages where readers craft, send, and inspect real API requests without leaving your documentation. Mintlify generates the playground from an [OpenAPI](#openapi) document. See [API playground overview](/api-playground/overview).
+
 ### Assistant
 
 An AI interface for documentation readers that answers questions from your content. It cites relevant pages and can navigate users directly to the relevant content. The assistant does not edit your documentation. See [Assistant](/assistant).
@@ -58,7 +62,7 @@

 ### Credits

 Units that measure use of Mintlify AI features. Credits are pooled across an organization and shared by its deployments and members. See [Credits](/credits).

 ### Custom domain

@@ -72,7 +76,7 @@

 ### Deployment

 A documentation project within a Mintlify organization. A deployment connects source content and a deployment branch to a live site. The term can also refer to a specific build being published.

 ### Deployment branch


diff --git a/zh/ai/bring-your-own-model.mdx b/zh/ai/bring-your-own-model.mdx
@@ -1,6 +1,6 @@
 ---
 title: "使用自己的模型"
-description: "使用你自己的 LLM 提供商 API 密钥，并选择为 Mintlify assistant 和 agent 提供支持的模型。"
+description: "在 Enterprise 方案中，使用你自己的 LLM 提供商 API 密钥，并选择为 Mintlify assistant、agent 和自动化提供支持的模型。"
 keywords: ["BYOK", "密钥", "OpenRouter", "Anthropic", "OpenAI", "LLM", "API 密钥", "积分"]
 ---
 
@@ -46,7 +46,7 @@ Mintlify 会加密存储你的密钥，保存后不会再显示。
   ## 积分如何计算
 </div>
 
-使用自己的模型时，Mintlify 的 AI 产品仍会消耗[积分](/zh/credits)，但你所配置的部署会按降低后的费率计费。
+使用自己的模型时，Mintlify 的 AI 产品仍会消耗[积分](/zh/credits)，但你所配置的部署会按标准费率的一半计费。
 
 积分汇集在组织级别，因此降低后的费率仅适用于使用自己模型的部署上的 AI 用量。其他部署仍按标准费率从同一余额中扣除。
 

diff --git a/zh/components/mdx.mdx b/zh/components/mdx.mdx
@@ -52,7 +52,7 @@ export const platform = "ios";
 在块级形式中，请在开始标签后留一个空行，以便内容按块级 Markdown 解析。在表达式中，`<MDX>` 会去除其内容的公共前导缩进，因此你可以将其缩进以匹配周围的代码。
 
 <Note>
-  `<MDX>` 内的标题不会出现在页面的目录中。
+  `<MDX>` 内的标题会按文档顺序合并到页面的目录中。这包括从不渲染的分支中的标题，例如条件语句中未激活的一侧。
 </Note>
 
 <div id="limits">

diff --git a/zh/create/list-table.mdx b/zh/create/list-table.mdx
@@ -69,6 +69,21 @@ keywords: ["有序列表", "无序列表", "Markdown 表格", "表格格式"]
 ```
 
 
+<div id="task-list">
+  ### 任务列表
+</div>
+
+要创建任务列表，在无序列表标记后添加 `[ ]` 表示未勾选的复选框，或添加 `[x]` 表示已勾选的复选框。
+
+- [x] 已完成项
+- [ ] 未完成项
+
+```mdx
+- [x] 已完成项
+- [ ] 未完成项
+```
+
+
 <div id="tables">
   ## 表格
 </div>

diff --git a/zh/credits.mdx b/zh/credits.mdx
@@ -146,7 +146,7 @@ SEO 审计、写作风格检查和失效链接检测无需在每次代码变更
   ### 使用自己的模型
 </div>
 
-在 Enterprise 方案中，你可以提供自己的 LLM 提供商 API 密钥，并选择为 assistant、agent 和自动化提供支持的模型。用量按降低后的积分费率计量，你的提供商会直接向你收取推理费用。模型按部署配置，而不是针对整个组织。更多信息请参阅[使用自己的模型](/zh/ai/bring-your-own-model)。
+在 Enterprise 方案中，你可以提供自己的 LLM 提供商 API 密钥，并选择为 assistant、agent 和自动化提供支持的模型。用量按标准积分费率的一半计量，你的提供商会直接向你收取推理费用。模型按部署配置，而不是针对整个组织。更多信息请参阅[使用自己的模型](/zh/ai/bring-your-own-model)。
 
 <div id="find-whats-consuming-your-credits">
   ### 查找消耗积分的原因

diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
@@ -18,12 +18,12 @@ keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull reque
 
 </div>
 
-外观偏好与你的用户账户绑定，切换后立即生效。
+外观设置是个人偏好，只会为你改变编辑器，不会影响团队成员或你已发布的站点。
 
-- **Fit editor to full width**：让编辑区域横向铺满，而不使用默认的固定宽度栏。
+- **Fit editor to full width**：让编辑区域横向铺满，而不使用默认的 768px 栏宽。
 - **Show breadcrumbs**：在编辑区域上方显示该页面在站点导航中的位置。
-- **Open live preview in new tab**：预览时在新的浏览器标签页中打开渲染后的页面。若要在[实时预览](/zh/editor/review#live-preview)中编辑站点设置，请保持关闭。
-- **Show all files**：在侧边栏中显示全部文件，包括 dotfile、代码、PDF，以及导航树默认隐藏的其他文件。
+- **Open live preview in new tab**：预览时在新的浏览器标签页中打开渲染后的页面，而不使用分栏预览。
+- **Show all files**：在侧边栏中显示全部文件，包括 dotfile、代码、PDF，以及其他默认隐藏的文件。你也可以按 <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd>（macOS）或 <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd>（Windows）进行切换。
 
 <div id="pr-instructions">