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.

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 com duas colunas de largura igual, conforme renderizada no GitHub. Os cabeçalhos são renderizados em negrito e as linhas de conteúdo alternativo têm sombreamento 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 com duas colunas de largura diferente, conforme renderizada no GitHub. 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 GitHub. Para obter mais informações, 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 com duas colunas de largura diferente, conforme renderizada no GitHub. Os comandos "git status" e "git diff" são formatados como blocos de código.

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 para o 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, podem ser exibidos dentro delas quando precedidos por uma barra invertida.

Leitura adicional