Skip to main content

Organizar informações com tabelas

Você pode criar tabelas para organizar as informações em comentários, problemas, pull requests e wikis.

Quem pode usar esse recurso?

O Markdown pode ser usado na interface Web do GitHub.

Criar uma tabela

Você pode criar tabelas com pipes | e hífens -. Hifens são usados para criar o cabeçalho de cada coluna, enquanto as barras verticais separam cada coluna. Você deve incluir uma linha em branco antes da tabela para ela ser construída corretamente.


| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

Captura de tela de uma tabela Markdown do GitHub renderizada como duas colunas iguais. Os cabeçalhos são mostrados em negrito, e as linhas de conteúdo alternativo têm sombreamento em cinza.

As barras verticais em cada extremo da tabela são opcionais.

As células podem ter largura variada e não precisam estar alinhadas perfeitamente com as colunas. Deve ter no mínimo três hifens em cada coluna da linha do cabeçalho.

| Command | Description |
| --- | --- |
| git status | List all new or modified files |
| git diff | Show file differences that haven't been staged |

Captura de tela de uma tabela Markdown do GitHub com duas colunas de larguras diferentes. As linhas listam os comandos "git status" e "git diff" e as respectivas descrições.

Se você estiver editando tabelas e snippets de código com frequência, poderá se beneficiar da habilitação de uma fonte de largura fixa em todos os campos de comentário no . Para saber mais, confira Sobre gravação e formatação no GitHub.

Formatar conteúdo dentro da tabela

Você pode usar formatação, como links, blocos de código embutidos e estilo de texto na tabela:

| Command | Description |
| --- | --- |
| `git status` | List all *new or modified* files |
| `git diff` | Show file differences that **haven't been** staged |

Captura de tela de uma tabela Markdown do GitHub com os comandos formatados como blocos de código. A formatação em negrito e itálico é usada nas descrições.

Você pode alinhar o texto à esquerda, à direita ou no centro de uma coluna incluindo dois pontos : à esquerda, direita ou nos dois lados dos hifens que estão dentro da linha de cabeçalho.

| Left-aligned | Center-aligned | Right-aligned |
| :---         |     :---:      |          ---: |
| git status   | git status     | git status    |
| git diff     | git diff       | git diff      |

Captura de tela de uma tabela Markdown com três colunas, conforme renderizada no GitHub, mostrando como o texto nas células pode ser definido com alinhamento à esquerda, ao centro ou à direita.

Para incluir uma barra vertical | como conteúdo dentro da célula, use \ antes da barra vertical:

| Name     | Character |
| ---      | ---       |
| Backtick | `         |
| Pipe     | \|        |

Captura de tela de uma tabela Markdown, conforme renderizada no GitHub, mostrando como os pipes, que normalmente fecham as células, são exibidos quando precedidos por uma barra invertida.

Leitura adicional