Organizar informações com tabelas

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 renderizada 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.

Os tubos em cada extremidade 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ê editar 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 saber mais, confira Sobre como escrever e formatar em 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 renderizada em GitHub mostrando como os pipes, que normalmente fecham as células, são exibidos quando precedidos por uma barra invertida.

Leitura adicional

          [GitHub Especificação do Flavored Markdown](https://github.github.com/gfm/)

        [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)

Quem pode usar esse recurso?

Neste artigo

Criar uma tabela

Formatar conteúdo dentro da tabela

Leitura adicional