Como usar
- Escolha a direção de Converter: CSV ou TSV para uma tabela Markdown, ou tabela Markdown para CSV.
- Cole o texto em Texto a converter. No CSV, a primeira linha é o cabeçalho da tabela.
- Em Alinhamento das colunas, mantenha Automático, que coloca os números à direita, ou escolha um lado para todas as colunas.
- Copie a Tabela Markdown ou o CSV, o que a direção escolhida gerar.
A sintaxe da tabela Markdown
Uma tabela na extensão de tabelas do GitHub Flavored Markdown tem uma linha de cabeçalho, uma linha de separação e linhas do corpo. As células ficam entre barras verticais, e a linha de separação tem uma célula para cada coluna, feita de hifens com dois-pontos opcionais em qualquer extremidade. A especificação GFM (em inglês) diz que a linha de separação deve ter tantas células quanto o cabeçalho. Dois-pontos à esquerda alinham a coluna à esquerda, dois-pontos à direita a alinham à direita, e dois-pontos dos dois lados a centralizam.
Uma linha do corpo com menos células que o cabeçalho ganha células vazias. Uma linha do corpo com mais células tem as células extras ignoradas. Uma barra vertical dentro de uma célula é escrita com uma barra invertida na frente, para que o renderizador a mantenha na célula.
| cabeçalho | cabeçalho | depois | --- | ---: | depois | corpo | corpo |Larguras das colunas, números e escape
Cada coluna tem a largura da sua célula mais larga, com um mínimo de três caracteres, então cada linha de uma tabela preenchida tem o mesmo comprimento. Uma coluna em que todas as células preenchidas são números é alinhada à direita, o que facilita comparar os dígitos. A largura é contada em caracteres, então uma letra larga pode não ficar perfeitamente alinhada.
Uma linha de tabela precisa ter uma linha só, então uma quebra de linha dentro de uma célula CSV é escrita como espaço. A leitura de CSV segue as regras usuais: uma célula que contém vírgula ou aspas fica entre aspas, e uma aspa dentro dela é duplicada.
- Escolha o separador você mesmo quando Detectar escolher o errado; uma planilha em português do Brasil costuma usar ponto e vírgula.
- Desligue Alinhar as colunas quando o Markdown for longo e o tamanho do arquivo importar mais que o layout do texto bruto.
Exemplo resolvido: uma lista de preços com barra vertical em um nome
O CSV tem o cabeçalho Product, Price, Stock e as linhas Tea, 12.5, 40 e Coffee | beans, 85, 12. A célula Coffee | beans tem 15 caracteres de largura depois que a barra vertical é escapada, então a coluna Product tem 15 de largura, e Price e Stock têm 5, porque os números são alinhados à direita.
A linha de separação é --------------- para Product, e ----: para Price e Stock. A linha de Coffee lê Coffee \| beans, seguido de 85 e 12 alinhados à direita. A tabela tem 2 linhas de dados e 3 colunas.
Perguntas frequentes
Por que uma barra vertical em uma célula precisa de uma barra invertida?
A barra vertical é o separador de colunas de uma tabela Markdown, então uma barra solta dentro de uma célula começaria uma nova coluna. A barra invertida na frente dela a mantém na célula, e a tabela renderizada mostra uma barra só.
Os espaços acrescentados para alinhar mudam a aparência da tabela?
Não. Os renderizadores ignoram os espaços ao redor do texto de uma célula, então a tabela fica igual. O preenchimento só deixa o Markdown bruto mais fácil de ler em um editor.
Por que as colunas de números são alinhadas à direita?
Os dígitos são mais fáceis de comparar quando as últimas casas se alinham, então o alinhamento automático põe uma coluna de números à direita. Uma coluna com algum texto fica simples, à esquerda.
O que acontece com uma quebra de linha dentro de uma célula CSV?
Uma linha de tabela precisa estar em uma linha só, então a ferramenta escreve uma quebra de linha dentro de uma célula como espaço. O texto da célula continua o mesmo, exceto por esse espaço.
Onde as tabelas Markdown aparecem corretamente?
O GitHub e a maioria das ferramentas de Markdown que seguem a extensão de tabelas do GFM as exibem. Alguns renderizadores de Markdown simples não têm sintaxe de tabela, então verifique o lugar onde você vai publicar a tabela.
O texto que eu colo é enviado ou guardado em algum lugar?
Não. A tabela e o CSV são feitos no seu navegador. Nada é guardado nem enviado para o nosso servidor, então copie o resultado antes de sair da página.
Fontes
- GitHub Flavored Markdown Spec (em inglês), tables extension
- IETF (em inglês): RFC 4180, Common Format and MIME Type for CSV Files
Números e texto verificados pela última vez em terça-feira, 10 de novembro de 2026.