From e794690cff77e53a04231b116e91576a591db67e Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 1 Sep 2026 06:33:27 +0000 Subject: [PATCH 1/2] docs: document table column widths with colgroup --- create/list-table.mdx | 62 ++++++++++++++++++++++++++++++++++++++ es/create/list-table.mdx | 64 ++++++++++++++++++++++++++++++++++++++++ fr/create/list-table.mdx | 64 ++++++++++++++++++++++++++++++++++++++++ zh/create/list-table.mdx | 64 ++++++++++++++++++++++++++++++++++++++++ 4 files changed, 254 insertions(+) diff --git a/create/list-table.mdx b/create/list-table.mdx index 4150364a8d..f7fb1834d2 100644 --- a/create/list-table.mdx +++ b/create/list-table.mdx @@ -119,3 +119,65 @@ Use colons in the separator row to align column content: | Left | Center | Right | | Text | Text | Text | ``` + +### Column widths + +Markdown tables size their columns automatically based on content. To control column widths, write the table in HTML and add a `` element that sets a width on every ``. + +When every `` declares a width, through the `width` attribute or an inline style, the table uses your widths and wraps long content within each column. If any `` is missing a width, Mintlify ignores the declared widths and sizes columns based on content. Tables that are too wide for the page still scroll horizontally. + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterTypeDescription
namestringFull name of the user
agenumberReported age of the user
+ +```html + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterTypeDescription
namestringFull name of the user
agenumberReported age of the user
+``` diff --git a/es/create/list-table.mdx b/es/create/list-table.mdx index 5065af4060..a99b615952 100644 --- a/es/create/list-table.mdx +++ b/es/create/list-table.mdx @@ -140,3 +140,67 @@ Usa dos puntos en la fila de separación para alinear el contenido de las column | Izquierda | Centro | Derecha | | Texto | Texto | Texto | ``` + +
+ ### Ancho de columnas +
+ +Las tablas de Markdown ajustan el ancho de sus columnas automáticamente según el contenido. Para controlar el ancho de las columnas, escribe la tabla en HTML y agrega un elemento `` que defina un ancho en cada ``. + +Cuando cada `` declara un ancho, mediante el atributo `width` o un estilo en línea, la tabla usa tus anchos y ajusta el contenido largo dentro de cada columna. Si a algún `` le falta el ancho, Mintlify ignora los anchos declarados y ajusta las columnas según el contenido. Las tablas demasiado anchas para la página siguen desplazándose horizontalmente. + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParámetroTipoDescripción
namestringNombre completo del usuario
agenumberEdad reportada del usuario
+ +```html + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterTypeDescription
namestringFull name of the user
agenumberReported age of the user
+``` diff --git a/fr/create/list-table.mdx b/fr/create/list-table.mdx index 0a3c51beaa..76ddbe1c55 100644 --- a/fr/create/list-table.mdx +++ b/fr/create/list-table.mdx @@ -140,3 +140,67 @@ Utilisez les deux-points dans la ligne de séparation pour définir l’aligneme | Left | Center | Right | | Text | Text | Text | ``` + +
+ ### Largeur des colonnes +
+ +Les tableaux Markdown dimensionnent leurs colonnes automatiquement selon le contenu. Pour contrôler la largeur des colonnes, écrivez le tableau en HTML et ajoutez un élément `` qui définit une largeur sur chaque ``. + +Lorsque chaque `` déclare une largeur, via l'attribut `width` ou un style en ligne, le tableau applique vos largeurs et fait passer le contenu long à la ligne dans chaque colonne. Si une `` n'a pas de largeur, Mintlify ignore les largeurs déclarées et dimensionne les colonnes selon le contenu. Les tableaux trop larges pour la page continuent de défiler horizontalement. + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParamètreTypeDescription
namestringNom complet de l'utilisateur
agenumberÂge déclaré de l'utilisateur
+ +```html + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterTypeDescription
namestringFull name of the user
agenumberReported age of the user
+``` diff --git a/zh/create/list-table.mdx b/zh/create/list-table.mdx index fd4b0653b7..95ca3b1479 100644 --- a/zh/create/list-table.mdx +++ b/zh/create/list-table.mdx @@ -140,3 +140,67 @@ keywords: ["有序列表", "无序列表", "Markdown 表格", "表格格式"] | 左对齐 | 居中对齐 | 右对齐 | | 文本 | 文本 | 文本 | ``` + +
+ ### 列宽 +
+ +Markdown 表格会根据内容自动调整列宽。要控制列宽，请使用 HTML 编写表格，并添加一个为每个 `` 设置宽度的 `` 元素。 + +当每个 `` 都通过 `width` 属性或内联样式声明宽度时，表格会使用你设置的宽度，并在每列内换行显示过长的内容。如果任何 `` 缺少宽度，Mintlify 会忽略声明的宽度并根据内容调整列宽。超出页面宽度的表格仍然可以水平滚动。 + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数类型描述
namestring用户的全名
agenumber用户报告的年龄
+ +```html + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterTypeDescription
namestringFull name of the user
agenumberReported age of the user
+``` From db6fb842ca0a57a682fd60a4b1bd07a3e6523227 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 2 Sep 2026 10:17:10 -0700 Subject: [PATCH 2/2] Update create/list-table.mdx --- create/list-table.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/create/list-table.mdx b/create/list-table.mdx index f7fb1834d2..1d8dd02b40 100644 --- a/create/list-table.mdx +++ b/create/list-table.mdx @@ -124,7 +124,7 @@ Use colons in the separator row to align column content: Markdown tables size their columns automatically based on content. To control column widths, write the table in HTML and add a `` element that sets a width on every ``. -When every `` declares a width, through the `width` attribute or an inline style, the table uses your widths and wraps long content within each column. If any `` is missing a width, Mintlify ignores the declared widths and sizes columns based on content. Tables that are too wide for the page still scroll horizontally. +When every `` declares a width, through the `width` attribute or an inline style, the table uses your widths and wraps long content within each column. If any `` is missing a width, Mintlify ignores the declared widths and sizes columns based on content. Tables that are too wide for the page scroll horizontally.