Como criar tabelas no Markdown

Tabelas no editor Markdown permitem que você organize e apresente dados em um formato estruturado e legível — útil para comparar recursos, opções de listagem ou resumir informações. Existem duas maneiras de criar uma tabela no editor Markdown: usando o ícone da barra de ferramentas Inserir tabela ou digitando manualmente a sintaxe da tabela Markdown.

Quando usar tabelas

• Comparações de recursos — exibam diferenças entre plantas, opções ou configurações lado a lado.
• Dados de referência — liste parâmetros, nomes de campos ou configurações com suas descrições em um formato estruturado.
• Resumos estruturados — apresentam conjuntos de dados onde linhas e colunas tornam as relações entre valores imediatamente claras.

Referência rápida

Sintaxe da tabela Markdown

| Column 1 | Column 2 | Column 3 |
|:-------- |:--------:| --------:|
| Left     | Center   | Right    |

Alinhamento das colunas

Limites

Como criar uma tabela no Markdown

Usando a barra de ferramentas

1. Abra o artigo desejado no editor Markdown do portal da Base de Conhecimento.

2. Clique no ícone Inserir tabela (⊞) na barra de ferramentas do editor.

   Uma grade interativa aparece.

3. Arraste para selecionar o número de linhas e colunas que você precisa. Você pode selecionar até 10 colunas × 15 linhas.

4. Para adicionar mais linhas além da seleção inicial, mova-se para uma nova linha abaixo da tabela e insira o conteúdo das células usando tubos verticais (|) para separar cada coluna. Cada nova linha representa uma linha.

   Exemplo:

   | Basic | Yes | Limited | Like    |
   | Pro   | Yes | Full    | Dislike |
   

Digitando manualmente

1. Abra o artigo desejado no editor Markdown.

2. Tipagem pipes verticais (|) e hífens (-) para definir a estrutura da tabela. Use dois pontos (:) na linha do separador para definir o alinhamento das colunas.

   Código de exemplo:

   | Column 1 | Column 2 | Column 3 |
   |:-------- |:--------:| --------:|
   | Left     | Center   | Right    |
   

3. A fileira de separadores (segunda linha) é necessária. Sem ele, o conteúdo não será renderizado como uma tabela.

Desfecho:

Como criar uma tabela sem uma linha de cabeçalho

O Markdown padrão sempre exige uma linha de cabeçalho. Se você precisar de uma tabela sem cabeçalho visível, use a sintaxe HTML <table> em vez disso:

<table>
  <tr>
    <td>Row 1</td>
    <td>Value 1</td>
  </tr>
  <tr>
    <td>Row 2</td>
    <td>Value 2</td>
  </tr>
</table>

Adicione mais <tr> blocos para linhas adicionais e mais <td> células dentro de cada linha para colunas adicionais, seguindo a mesma estrutura.

Saída:

Melhores práticas

• Sempre inclua uma linha de cabeçalho — mesmo que os nomes das colunas sejam genéricos (Coluna 1, Coluna 2), uma linha de cabeçalho facilita a varredura da tabela e é necessária para a sintaxe padrão do Markdown.
• Mantenha o conteúdo das células conciso — texto longo nas células dificulta a leitura das tabelas. Se uma célula precisar de mais de uma frase, considere usar uma lista ou parágrafo em vez disso.
• Use o alinhamento intencionalmente — alinhe colunas de texto à esquerda, colunas numéricas alinhe à direita e use o alinhamento central com moderação para rótulos ou valores de status.
• Use a barra de ferramentas para tabelas rápidas — o ícone Inserir tabela é a maneira mais rápida de criar uma tabela padrão. Mude para a sintaxe manual quando precisar de controle preciso sobre o alinhamento ou estiver adicionando linhas além do limite de 15 linhas da barra de ferramentas.