Como converter texto delimitado em tabela Markdown

Para que serve a conversão de texto em tabela Markdown

Para transformar dados separados por um carácter numa tabela Markdown, indique o delimitador usado no texto e escolha como deve ser tratada a primeira linha. Esta abordagem é útil quando recebe dados simples em linhas, por exemplo de uma folha de cálculo, de uma exportação ou de uma lista preparada manualmente. O resultado é uma tabela Markdown que pode ser copiada para documentação, notas técnicas ou outro conteúdo compatível com este formato.

O processamento considera cada linha não vazia como uma linha de dados e divide-a nas células segundo o delimitador selecionado. Os espaços no início e no fim do texto e de cada célula são removidos, enquanto as linhas vazias são ignoradas.

Como converter texto delimitado numa tabela Markdown

1. Prepare pelo menos duas linhas não vazias de texto. Coloque uma linha por registo e separe as células com o mesmo carácter em todas as linhas.

2. Introduza o texto no campo de entrada. Se não escolher outro carácter, a vírgula será usada como delimitador. Para dados separados por ponto e vírgula, tabulação ou outro carácter, selecione o delimitador correspondente nas opções disponíveis.

3. Decida se a primeira linha contém os nomes das colunas. Por predefinição, a primeira linha é tratada como cabeçalho. Se desativar essa opção, serão criados rótulos genéricos para as colunas.

4. Escolha o alinhamento das células: à esquerda, ao centro ou à direita. O alinhamento à esquerda é o valor predefinido.

5. Execute a conversão e reveja a tabela Markdown produzida. Confirme se o delimitador escolhido corresponde ao que aparece no texto e se as linhas têm as células esperadas.

Se uma linha tiver menos células do que a linha mais larga, serão acrescentadas células vazias antes de a tabela ser construída. Assim, verifique também as linhas com dados incompletos. Um valor de alinhamento fora das opções suportadas é tratado como alinhamento à esquerda.

Como ler e validar o resultado

Uma conversão bem-sucedida produz uma tabela Markdown com uma estrutura regular: uma linha de cabeçalho quando essa opção está ativa, uma linha separadora e as linhas de dados. Quando o tratamento de cabeçalho está desativado, a primeira linha deixa de fornecer os nomes das colunas e são usados rótulos genéricos.

Se o resultado apresentar poucas colunas, verifique primeiro o delimitador. O texto é dividido em cada linha não vazia com base no carácter fornecido; por isso, um separador diferente do escolhido altera a forma como as células são reconhecidas. Se faltarem valores numa linha, a tabela mantém a largura da linha mais larga e preenche as posições em falta com células vazias.

A ferramenta trabalha com texto delimitado simples. A revisão manual continua a ser importante quando os dados contêm caracteres que também são usados como separadores ou quando a estrutura das linhas não é uniforme.

Exemplo prático

Tem um texto com duas linhas não vazias: «Nome;Idade» e «Ana;30», em que o ponto e vírgula separa as duas colunas.

Defina o ponto e vírgula como delimitador, mantenha o tratamento da primeira linha como cabeçalho e escolha o alinhamento à esquerda. Converta o texto para obter a tabela Markdown.

O resultado tem uma linha de cabeçalho com Nome e Idade, uma linha separadora Markdown e uma linha de dados com Ana e 30; as células ficam alinhadas à esquerda por predefinição.

Limitações

• A conversão baseia-se na divisão de cada linha não vazia pelo delimitador fornecido. Reveja manualmente os dados quando houver separadores dentro dos valores ou quando a estrutura das linhas não for uniforme.

Erros comuns

• Causa: o delimitador selecionado não corresponde ao carácter entre as células, pelo que cada linha pode ser lida como uma única célula ou ser dividida de forma inesperada. Correção: selecione o mesmo carácter usado no texto e volte a converter.

Perguntas frequentes

Quantas linhas são necessárias para criar uma tabela Markdown?

São necessárias pelo menos duas linhas não vazias; as linhas vazias são ignoradas antes da conversão.

A primeira linha é usada como cabeçalho?

Sim, por predefinição. Ao desativar essa opção, a primeira linha deixa de ser usada para nomear as colunas e são criados rótulos genéricos.

Que alinhamentos estão disponíveis?

Pode escolher o alinhamento à esquerda, ao centro ou à direita. Um valor fora dessas opções é tratado como alinhamento à esquerda.