Este guia explica como adicionar tabelas às suas publicações do Discourse usando Markdown.
Nível de usuário necessário: Todos os usuários
Adicionar tabelas às suas publicações pode ajudar a apresentar dados em um formato estruturado e fácil de ler. Este guia mostrará como criar tabelas em Markdown no Discourse, abordando os conceitos básicos das tabelas, alinhamento e recursos especiais, como adicionar emojis e imagens.
Usando o Construtor de Tabelas
O Discourse inclui um Construtor de Tabelas integrado que permite criar e editar tabelas usando uma interface semelhante a uma planilha — sem necessidade de conhecimento de Markdown.
Para inserir uma nova tabela:
- Abra o editor de composição
- Clique no botão
na barra de ferramentas (o menu de opções) - Selecione Inserir tabela
- Use o editor de planilha para adicionar seus cabeçalhos e dados
- Clique em Construir Tabela para inserir a tabela Markdown gerada na sua publicação
Para editar uma tabela existente em uma publicação, clique no botão 
Editar Tabela que aparece acima da tabela (visível para usuários com permissões de edição). Isso abre o mesmo editor de planilha pré-preenchido com os dados da tabela.
Criando uma tabela simples
Criar uma tabela no Discourse usando Markdown é simples. Aqui está um guia passo a passo:
- Comece definindo o cabeçalho:
- A primeira linha da sua tabela conterá os cabeçalhos de cada coluna.
- A segunda linha separa os cabeçalhos do restante da tabela.
Aqui está um exemplo de uma tabela com três colunas:
| Col A | Col B | Col C |
|---|---|---|
Isso resulta em:
| Col A | Col B | Col C |
|---|
- Adicione linhas de dados:
- Cada linha começa e termina com o caractere
|. - Certifique-se de que o número de colunas corresponda ao do cabeçalho.
Exemplo:
| Col A | Col B | Col C |
|---|---|---|
| A1 | B1 | C1 |
| A2 | B2 | :smile: |
Isso resulta em:
| Col A | Col B | Col C |
|---|---|---|
| A1 | B1 | C1 |
| A2 | B2 |  |
Alinhamento
Você pode controlar o alinhamento do conteúdo da coluna com dois pontos (:):
- Alinhado à esquerda:
|:---| - Centralizado:
|:---:| - Alinhado à direita:
|---:|
Exemplo:
| Esquerda | Centro | Direita |
|:---|:---:|---:|
| Meu conteúdo está à esquerda | Eu sou o centro do mundo | Eu gosto de ficar no lado direito |
| :waxing_gibbous_moon: | :full_moon: | :waning_gibbous_moon: |
Isso resulta em:
| Esquerda | Centro | Direita |
|---|---|---|
| Meu conteúdo está à esquerda | Eu sou o centro do mundo | Eu gosto de ficar no lado direito |
 |
 |
 |
Links clicáveis em Tabelas
Adicionar links clicáveis dentro de tabelas pode ser útil para direcionar os usuários a recursos específicos ou conteúdo externo.
Para incluir um link clicável, use a sintaxe de link Markdown padrão dentro de uma célula de tabela. O formato é [Texto do Link](URL).
Exemplo:
| Coluna A | Coluna B | Coluna C |
|---|---|---|
| [Google](https://www.google.com) | Texto de Exemplo | Outro Link |
Isso resulta em:
| Coluna A | Coluna B | Coluna C |
|---|---|---|
| Texto de Exemplo | Outro Link |
Imagens em Tabelas
Para usar imagens em tabelas, você precisará usar o caractere de escape \ antes do pipe | no código da imagem após carregá-la.
Exemplo:
Imagem | Descrição
---|---
 | Um Chihuahua saboreando um expresso em um café.
Isso resulta em:
Imagens Clicáveis em Tabelas
Para tornar uma imagem clicável, você pode aninhar a sintaxe Markdown da imagem dentro da sintaxe Markdown do link. Aqui está o formato básico:
[](URL do link)
O texto alternativo é importante para acessibilidade, pois descreve a imagem se ela não carregar ou for usada por leitores de tela. Sempre use texto alternativo significativo.
Veja como você pode incorporar imagens clicáveis em uma tabela Markdown:
| Imagem 1 |
|---|
| [](https://meta.discourse.org/)
Isso resulta em:
| Imagem 1 |
|---|
 |
Copiar e colar tabelas
Você pode copiar tabelas de documentos externos ou planilhas e colá-las diretamente nas publicações; o Discourse as converterá automaticamente em Markdown.
Se você cria tabelas com frequência, também pode usar ferramentas como TableConvert para converter tabelas de outros formatos (CSV, JSON, etc.) em Markdown.
