Skip to content

Update from code changes: document table column widths #7211

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ethanpalm merged 2 commits into from
Sep 2, 2026
+254 −0
Merged

Update from code changes: document table column widths #7211

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e794690
docs: document table column widths with colgroup
mintlify[bot] Sep 1, 2026
db6fb84
Update create/list-table.mdx
ethanpalm Sep 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 62 additions & 0 deletions create/list-table.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,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.

Check warning on line 95 in create/list-table.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

create/list-table.mdx#L95 

In general, use active voice instead of passive voice ('is treated').

| Value | Description |
| ------------- | --------------------------------- |
Expand All @@ -119,3 +119,65 @@
| 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 `<colgroup>` element that sets a width on every `<col>`.

When every `<col>` 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 `<col>` 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.

<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>Full name of the user</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>Reported age of the user</td>
</tr>
</tbody>
</table>

```html
<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>Full name of the user</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>Reported age of the user</td>
</tr>
</tbody>
</table>
```
64 changes: 64 additions & 0 deletions es/create/list-table.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
```

<div id="column-widths">
### Ancho de columnas
</div>

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 `<colgroup>` que defina un ancho en cada `<col>`.

Cuando cada `<col>` 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 `<col>` 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.

<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>Parámetro</th>
<th>Tipo</th>
<th>Descripción</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>Nombre completo del usuario</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>Edad reportada del usuario</td>
</tr>
</tbody>
</table>

```html
<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>Full name of the user</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>Reported age of the user</td>
</tr>
</tbody>
</table>
```
64 changes: 64 additions & 0 deletions fr/create/list-table.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
```

<div id="column-widths">
### Largeur des colonnes
</div>

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 `<colgroup>` qui définit une largeur sur chaque `<col>`.

Lorsque chaque `<col>` 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 `<col>` 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.

<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>Paramètre</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>Nom complet de l'utilisateur</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>Âge déclaré de l'utilisateur</td>
</tr>
</tbody>
</table>

```html
<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>Full name of the user</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>Reported age of the user</td>
</tr>
</tbody>
</table>
```
64 changes: 64 additions & 0 deletions zh/create/list-table.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -140,3 +140,67 @@ keywords: ["有序列表", "无序列表", "Markdown 表格", "表格格式"]
| 左对齐 | 居中对齐 | 右对齐 |
| 文本 | 文本 | 文本 |
```

<div id="column-widths">
### 列宽
</div>

Markdown 表格会根据内容自动调整列宽。要控制列宽，请使用 HTML 编写表格，并添加一个为每个 `<col>` 设置宽度的 `<colgroup>` 元素。

当每个 `<col>` 都通过 `width` 属性或内联样式声明宽度时，表格会使用你设置的宽度，并在每列内换行显示过长的内容。如果任何 `<col>` 缺少宽度，Mintlify 会忽略声明的宽度并根据内容调整列宽。超出页面宽度的表格仍然可以水平滚动。

<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>用户的全名</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>用户报告的年龄</td>
</tr>
</tbody>
</table>

```html
<table>
<colgroup>
<col width="25%" />
<col width="15%" />
<col width="60%" />
</colgroup>
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>Full name of the user</td>
</tr>
<tr>
<td>age</td>
<td>number</td>
<td>Reported age of the user</td>
</tr>
</tbody>
</table>
```