Você montou uma tabela no Excel ou no Google Sheets e agora quer colocá-la em um README do GitHub, em uma página do Notion ou em um documento. Mas copiar a tabela e colar não gera a tabela Markdown que você vê na tela. Este guia cobre a forma mais rápida de transformar uma seleção de planilha em uma tabela Markdown e como identificar por que uma tabela saiu quebrada.
Quer agora? Selecione o intervalo no Excel ou no Google Sheets, copie, cole na ferramenta CSV to Markdown e clique em Run. Sem upload, sem instalar nada. Se você prefere entender primeiro como funciona e as armadilhas, continue lendo.
O caminho mais rápido: copiar, colar, converter
Excel, Google Sheets e LibreOffice Calc funcionam todos da mesma forma.
- Selecione o intervalo que quer converter e copie (Ctrl+C / Cmd+C).
- Abra o CSV to Markdown e cole no painel da esquerda (Ctrl+V / Cmd+V).
- Pressione Run. O painel da direita é preenchido com uma tabela Markdown compatível com o GitHub.
A primeira linha é tratada como o cabeçalho. A saída está pronta para colar direto em um README ou uma issue.
O que acontece quando você copia de uma planilha
Esta é a diferença principal em relação a um arquivo CSV. Quando você copia um intervalo do Excel ou do Sheets e cola em uma caixa de texto, o que chega à caixa não é separado por vírgulas — é texto separado por tabulação (TSV). Cada célula é separada por um caractere de tabulação e cada linha por uma quebra de linha.
name email role
Mika mika@example.com admin
Noah noah@example.com viewer
Os espaços entre as colunas acima são caracteres de tabulação, não espaços. A ferramenta CSV to Markdown detecta automaticamente o delimitador do texto colado, então uma entrada separada por tabulação é convertida diretamente. Você não precisa salvar nada como CSV antes: basta colar.
Converta com o FormatArc
O CSV to Markdown recebe os dados colados e os molda em uma tabela compatível com GFM. Não há nada para instalar.
Passo 1: Abra a ferramenta
Acesse o CSV to Markdown.
Passo 2: Copie da planilha e cole
Selecione o intervalo no Excel ou no Sheets, copie e cole no painel da esquerda. Como observado acima, o texto colado vem separado por tabulação, e a ferramenta reconhece isso automaticamente.
Passo 3: Clique em Run
Pressione Run. O painel da direita é preenchido com a tabela Markdown.
A contagem de colunas e a largura dos separadores são normalizadas para você, então a saída está pronta para copiar e colar.
Converter sem fazer upload
Tudo roda no navegador. Os dados colados nunca são enviados para um servidor. Planilhas internas de vendas, listas de clientes e outras planilhas que você prefere não compartilhar podem ser convertidas com segurança. Para ver como isso difere de conversores online baseados em upload, veja conversores online são seguros?.
Por que uma tabela sai quebrada e como corrigir
Colar e pressionar Run funciona com cópias normais, mas alguns padrões podem quebrar o resultado. Conhecer a causa torna a correção rápida.
Vírgulas nos números deslocam as colunas
Esse é o mais comum. Se muitas células contêm um separador de milhar como 1,200,000, a detecção automática do delimitador pode escolher a vírgula em vez da tabulação, partindo os números no meio e deslocando as colunas. Enquanto o colado permanecer separado por tabulação, vírgulas dentro dos valores são seguras, mas quando as células com vírgula predominam, a detecção pende para a vírgula.
Duas formas de corrigir:
- Remova a exibição do separador de milhar na planilha (defina o formato numérico como simples, sem vírgulas) antes de copiar.
- Se você precisa manter os separadores, exporte os dados como um CSV com os campos numéricos entre aspas e cole isso em vez do colado direto.
Barras verticais dentro das células
Se uma célula contém |, ela não pode ser distinguida de um separador de coluna como está. O FormatArc a escapa como \| automaticamente, então você não precisa cuidar disso ao colar.
| x | y |
| --- | --- |
| foo\|bar | baz |
Quebras de linha dentro das células
A especificação de tabelas Markdown não tem como representar uma quebra de linha dentro de uma célula. O FormatArc as substitui por espaços. Se você precisa de uma quebra de linha visível, coloque uma tag <br> explícita nos seus dados de origem, embora se <br> aparece como quebra dependa de onde você cola (GitHub, Notion e Qiita se comportam de formas diferentes).
Linhas irregulares
Se o cabeçalho tem 3 colunas mas uma linha de dados tem 4, as colunas que passam da contagem do cabeçalho são descartadas. Se uma linha de dados é mais curta, as células que faltam são preenchidas com strings vazias, de modo que a saída continua sendo uma tabela válida. Para ver como células vazias se comportam, o cheatsheet de tabelas GFM é uma referência útil.
Cópia direta versus salvar como CSV
Há dois pontos de entrada de uma planilha para o Markdown.
- Copiar e colar diretamente (separado por tabulação): rápido e simples. Na maioria das vezes é suficiente.
- Salvar primeiro como arquivo CSV e depois colar: melhor quando você precisa contornar os separadores de milhar por vírgula, ou reaproveitar um CSV que já tem.
Para converter a partir de um arquivo ou de uma string CSV, os passos completos estão em Como Converter CSV em Tabela Markdown. Para o contexto sobre o que é o CSV em si, veja O que é CSV.
Para onde vai a tabela convertida
READMEs do GitHub
Listas de endpoints de API, opções suportadas, comparações de bibliotecas — tabelas em README aparecem o tempo todo. Mantenha a origem em uma planilha e atualizar passa a ser colar de novo em vez de editar à mão. Para o layout específico de README, veja Criar uma tabela no README do GitHub.
Pull requests e issues
Números de benchmark e listas de casos de teste ficam mais legíveis como tabelas, o que facilita o acompanhamento pelos revisores. Agregue os dados em uma planilha, converta, cole.
Notion, Obsidian, Zenn, Qiita
Todas falam Markdown. Transformar os dados da planilha em uma tabela Markdown elimina a necessidade de reformatar toda vez que você muda de plataforma.
Contexto para LLMs
Alimentar uma tabela para o ChatGPT, o Claude ou o Gemini funciona melhor como Markdown do que como HTML bruto: usa menos tokens e é extraída com mais precisão. Veja Markdown vs HTML para LLMs para números medidos de custo em tokens e precisão de extração.
Encerrando
Quando você copia uma tabela do Excel ou do Google Sheets, obtém texto separado por tabulação. O CSV to Markdown detecta isso automaticamente, então selecione o intervalo, copie, cole e pressione Run para receber uma tabela Markdown. Só quando vírgulas nos números deslocam as colunas você precisa remover a formatação ou passar por um CSV salvo.
Para ajustar a sintaxe e o alinhamento da tabela, veja Tabelas em Markdown: Sintaxe, Alinhamento e Exemplos para Copiar e Colar. Para uma referência rápida de sintaxe, o cheatsheet de tabelas GFM também é útil.