Como converter JSON ou CSV numa tabela Markdown

O que pode converter

Este conversor transforma texto em JSON ou CSV numa tabela Markdown quando o processamento é concluído com sucesso. É útil quando tem dados simples em texto e precisa de uma representação tabular que possa copiar para documentação, notas técnicas ou um ficheiro Markdown.

A ferramenta trabalha com dois formatos: json e csv. No caso do JSON, uma lista de objetos pode formar várias linhas, enquanto um objeto JSON não vazio é tratado como uma única linha. Também pode indicar cabeçalhos personalizados e escolher o alinhamento das células. Se não indicar cabeçalhos, o resultado depende do formato selecionado: no JSON adequado, são usados os nomes das chaves da primeira linha; no CSV, a primeira linha fornece os cabeçalhos.

Como gerar a tabela

1. Prepare o conteúdo no formato pretendido. Para JSON, use uma estrutura adequada para linhas de tabela, como uma lista de objetos com chaves consistentes. Um objeto não vazio será tratado como uma única linha. Para CSV, coloque os cabeçalhos na primeira linha se quiser que sejam usados automaticamente, seguidos pelas linhas de dados.

2. Cole o texto no campo de dados. Não o deixe vazio: a submissão sem dados falha em vez de gerar uma tabela.

3. Selecione o formato json ou csv. Não escolha outro valor, porque apenas estas duas opções são suportadas.

4. Se necessário, preencha o campo opcional de cabeçalhos com nomes separados por vírgulas. Os espaços no início e no fim de cada nome são removidos. Quando não fornece cabeçalhos personalizados, o JSON adequado usa as chaves da primeira linha e o CSV usa a primeira linha do próprio conteúdo.

5. Escolha o alinhamento left, center ou right. left é a opção predefinida. Se for introduzido outro valor, os marcadores da tabela ficam alinhados à esquerda.

6. Execute o processamento e copie o texto Markdown produzido. Se o resultado não for gerado, confirme primeiro se há dados, se o formato selecionado corresponde ao conteúdo e se o JSON é válido. No CSV, mantenha em mente que a divisão é feita diretamente por linhas e vírgulas: não conte com tratamento especial para vírgulas entre aspas ou outras convenções avançadas.

Como ler o resultado

Uma execução bem-sucedida produz texto de tabela Markdown, com uma linha de cabeçalho, linhas de separação e linhas de dados. No JSON, os cabeçalhos sem personalização vêm das chaves da primeira linha quando a estrutura é adequada. No CSV, a primeira linha é interpretada como cabeçalho e as linhas seguintes como dados, desde que não sejam substituídas por cabeçalhos personalizados.

Um resultado vazio não significa necessariamente que tenha sido criada uma tabela sem linhas de dados. Valores JSON vazios, como uma lista vazia, um objeto vazio, null, false, zero ou uma cadeia vazia, são tratados como uma tabela vazia. JSON malformado também não produz um resultado bem-sucedido, e algumas estruturas JSON válidas podem falhar se não fornecerem a forma esperada para uma tabela.

No CSV, os espaços exteriores de cada campo são removidos. Campos que aparecem depois da quantidade de cabeçalhos são descartados, enquanto campos em falta dão origem a valores vazios. Assim, reveja o número de colunas antes de usar a tabela em documentação que exija correspondência rigorosa entre todas as linhas.

Exemplo prático

Tem uma lista JSON com dois objetos, cada um contendo as chaves nome e quantidade, e quer convertê-la numa tabela Markdown para documentação.

Cole o conteúdo JSON, selecione json, não indique cabeçalhos personalizados, mantenha o alinhamento predefinido e execute o processamento.

O resultado tem uma linha de cabeçalho com nome e quantidade, uma linha separadora Markdown e duas linhas de dados, com o conteúdo distribuído pelas colunas correspondentes.

Limitações

• O CSV é dividido diretamente por linhas e vírgulas. Campos posteriores ao número de cabeçalhos são descartados e campos em falta ficam vazios; convenções avançadas, como delimitadores entre aspas, não estão estabelecidas.
• Valores JSON vazios resultam numa tabela vazia, e algumas estruturas JSON válidas podem falhar quando não têm a forma esperada para linhas de tabela.

Erros comuns

• Se o JSON estiver malformado ou tiver uma estrutura válida mas incompatível com uma tabela, o processamento pode falhar. Corrija a sintaxe e reorganize os dados numa estrutura de linhas adequada antes de tentar novamente.

Perguntas frequentes

Posso converter um objeto JSON numa tabela?

Sim, desde que o objeto JSON não esteja vazio e forneça uma estrutura adequada para uma linha de tabela. Um objeto não vazio é tratado como uma única linha; um objeto vazio produz uma tabela vazia.

É possível definir os cabeçalhos da tabela?

Pode, usando nomes separados por vírgulas no campo opcional de cabeçalhos. Os espaços exteriores de cada nome são removidos e os cabeçalhos personalizados substituem os cabeçalhos obtidos automaticamente.

Que alinhamentos estão disponíveis?

O alinhamento predefinido é left, mas também pode selecionar center ou right. Outro valor fica sujeito ao alinhamento à esquerda.