Como converter JSON em tabela HTML ou Markdown

Para que serve o conversor de JSON para tabela

Este conversor transforma um array JSON no nível superior numa tabela para consulta ou partilha. Pode escolher HTML, Markdown ou o formato combinado, consoante o destino do resultado. Quando o formato não é indicado, é usado HTML. A ferramenta não trata um objeto JSON isolado como entrada de tabela: o valor principal tem de ser um array.

Como converter o JSON passo a passo

1. Prepare um JSON cujo valor no nível superior seja um array. Por exemplo, [ {"produto":"Caderno","preco":3.5}, {"produto":"Caneta"} ]. Um texto vazio, JSON inválido ou um valor que não seja um array não gera uma tabela.

2. Cole o conteúdo no campo de entrada. Confirme que não existem caracteres adicionais antes ou depois do JSON e que a sintaxe está correta, incluindo aspas, vírgulas e chavetas.

3. Selecione o formato pretendido. HTML é a opção predefinida quando não é fornecido um formato; Markdown produz uma tabela Markdown; o formato combinado devolve as representações HTML e Markdown para um array não vazio.

4. Execute a conversão e consulte o resultado. Num array de valores simples, como ["Lisboa", "Porto"], a saída é uma tabela com uma coluna. Num array de objetos, as colunas seguem a ordem em que as chaves aparecem pela primeira vez. Se um objeto não tiver uma chave recolhida para a tabela, a célula correspondente fica vazia.

5. Escolha a representação adequada ao uso final. O HTML pode ser colocado numa página ou documento compatível. O Markdown é útil em ambientes que interpretam esse formato; os caracteres | nos valores são tratados para não confundirem a estrutura das células.

Como interpretar o resultado

Leia o resultado como uma representação tabular do array recebido, não como uma alteração do JSON original. Para objetos, a primeira ocorrência de cada chave define a ordem das colunas, e propriedades ausentes aparecem como células sem conteúdo. Em arrays de valores simples, existe apenas uma coluna.

Tenha atenção a arrays vazios: não produzem uma tabela. Arrays mistos, que combinam objetos com valores simples, podem ter linhas irregulares; os valores que não são objetos ficam apenas na primeira coluna, enquanto os objetos usam as colunas recolhidas. No Markdown, um array sem qualquer chave de coluna, como [{}], pode gerar linhas sem a linha de cabeçalho e o separador habituais. No HTML, os caracteres com significado especial nesse formato são escapados no conteúdo da tabela.

Exemplo prático

Uma pessoa recebe uma lista de produtos em JSON e precisa de a apresentar como tabela Markdown.

Cole o array no conversor, selecione Markdown e execute a conversão.

O resultado tem uma tabela com as colunas produto e preco. Na segunda linha, a célula de preco fica vazia porque essa chave não existe nesse objeto.

Limitações

• Arrays mistos podem produzir linhas irregulares. Arrays vazios não produzem tabela e, quando não existem chaves de coluna, o Markdown pode não incluir cabeçalho nem linha separadora.

Erros comuns

• Causa: colar um objeto como {"nome":"Ana"} ou deixar o campo vazio. Correção: forneça um array no nível superior, como [{"nome":"Ana"}], e valide o JSON antes de executar a conversão.

Perguntas frequentes

Posso converter um objeto JSON isolado?

Sim, desde que o valor JSON no nível superior seja um array não vazio. Um objeto isolado, texto vazio ou JSON inválido não produz saída tabular.

Que formato de saída devo escolher?

Pode. Quando não é indicado um formato, o resultado é HTML; também pode selecionar Markdown ou o formato combinado para obter as duas representações.

O que acontece se o array misturar objetos e valores simples?

Sim, mas a estrutura pode ficar irregular. Os valores que não são objetos ficam apenas na primeira coluna, enquanto os objetos usam as colunas recolhidas a partir das suas chaves.