Markdown Tabelas: um guia completo para GFM sintaxe de tabela

As tabelas Markdown permitem que você exiba dados estruturados em um formato legível que representa como uma tabela HTML. Este guia abrange a totalidade GFM (GitHub Aromatizado Markdown) sintaxe da tabela, opções de alinhamento, padrões avançados e como converter tabelas Word em Markdown.

Sintase básica da tabela

Uma tabela Markdown tem três partes:

1. Linha de cabeçalho nomes de colunas
2. Linha do separador placas com tubos, define a tabela
3. Linhas de dados o conteúdo

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |

Descrição:

Alinhamento da coluna

Utilize colunas na linha de separação para controlar o alinhamento:

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |

• :--- Alinhamento à esquerda (padrão)
• :---: Alinhamento do centro
• ---: Alinhamento direito

Formatar dentro de células de tabela

A maioria das formatações Markdown em linha funciona dentro de células de tabela:

| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |

O que não funciona: conteúdo de várias linhas, listas aninhadas, elementos de nível de bloco.

Caracteres de tubos em células

Se precisares de uma pipa literal | dentro de uma cela, escapar dela com um contra-slash:

| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |

Mesas sem espaçamento

O espaçamento entre os tubos é opcional. Isto é válido:

|Column 1|Column 2|
|---|---|
|Cell|Cell|

Mas espaçamento consistente torna as tabelas mais legíveis. A maioria dos editores e linters preferem o formato espaçado.

Células vazias

Deixar o espaço entre os tubos vazio para uma célula vazia:

| A | B | C |
|---|---|---|
| content | | content |
| | content | |

Conversão de tabelas Word para Markdown

Tabelas Word convertem automaticamente quando você usa WordToMD. The converter handles:

• Grelhas padrão → GFM mesas de tubulação
• Largura da coluna → padronizada (Markdown não controla a largura da coluna)
• Formato de texto dentro de células → preservado (em negrito, itálico, links)

O que não converte:

• Células fundidas (espanagem/espanagem de linhas) colapso para a célula mais próxima
• Conteúdo de células de várias linhas rupturas de linhas retiradas
• Mesas aninhadas mesa interior achatada

Manuseio de tabelas de palavras complexas

Células fundidas

Words células fundidas não têm Markdown equivalente. Opções:

1. Reestruturação Dividir linhas fundidas em tabelas separadas
2. Usar HTML A maioria dos processadores Markdown aceita a sintaxe da tabela HTML:

<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

Conteúdo de célula de várias linhas

Utilização <br> para interrupções de linha dentro de células (funciona em GitHub e na maioria das plataformas):

| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |

Mesas grandes

Para tabelas com muitas colunas, considere se uma tabela é o formato correto. Alternativas:

• Lista de definições (termo + descrição)
• Múltiplas tabelas menores por categoria
• Um bloco de código para dados estruturados (JSON, YAML)

Tabela de renderização por plataforma

Acessibilidade

Para uma melhor acessibilidade, certifique-se de que as tabelas tenham uma linha de cabeçalho com nomes de colunas significativos. Os leitores de tela usam a linha de cabeçalho para anunciar o contexto da célula.

| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |

Evitar a utilização de tabelas para fins de layout Usá-las apenas para dados de tabelas reais.

FAQ

Porque é que a minha tabela não está a ser apresentada como texto simples? A linha de separação (a |---|---| (linha) é obrigatório. Sem ele, o parser não reconhecerá a estrutura da tabela.

Posso ter uma mesa sem cabeçalho? Não em GFM padrão. Requer-se a linha de cabeçalho e o separador. Se não quiser um cabeçalho visível, use um cabeçalho em branco: | | | com uma linha de separação.

Por que as minhas tabelas de Word parecem certas em WordToMD mas erradas depois de as colar em outro lugar? O problema é geralmente espaços em branco em células ou caracteres de tubo inconsistentes. A maioria dos renderizadores Markdown são lenientes, mas o copiar-pelar pode introduzir caracteres invisíveis.

Como posso criar uma tabela programaticamente a partir de dados? Bibliotecas como markdown-table (npm) ou Pythons tabulate pode gerar tabelas Markdown a partir de matrizes. Isso é útil para a conversão em lote de CSV ou dados de banco de dados.

Guia Relacionado

• O que é o Markdown? Markdown fundamentos
• Markdown Síntase guia rápido Referência completa de sintaxe
• Como converter Word para Markdown Guia completo de conversão
• DOCX a Markdown com tabelas Concentrado na conversão de tabelas

Conclusão

As tabelas Markdown são poderosas para exibir dados estruturados e são amplamente suportadas em todas as principais plataformas. Para tabelas que começam em Word, WordToMD converte-os automaticamente para GFM sintaxe. Para layouts complexos, o backup HTML e os truques acima dão-lhe o controle que você precisa.