YAML para JSON: mantenha as quebras de linha que você quis
Um pipe, um sinal de maior e um sinal de menos produzem strings diferentes. Cinco pequenos exemplos mostram por quê.
Um parágrafo YAML pode parecer duas linhas no seu editor, mas virar uma única linha em JSON. O caractere após a chave decide como essas quebras de linha são lidas; um sinal de menos decide se a nova linha final permanece.
Abra o conversor de CSV, JSON e YAML, cole este exemplo, escolha YAML em De e JSON em Para:
literal: |
Ready to share.
Check the link.
folded: >
Ready to share.
Check the link.
literal_strip: |-
Ready to share.
Check the link.
folded_strip: >-
Ready to share.
Check the link.
Leia a saída antes de alterar o texto
O conversor produz estas quatro strings:
{
"literal": "Ready to share.\nCheck the link.\n",
"folded": "Ready to share. Check the link.\n",
"literal_strip": "Ready to share.\nCheck the link.",
"folded_strip": "Ready to share. Check the link."
}
No código-fonte JSON, \n representa uma nova linha dentro da string. Não é uma barra invertida extra que o leitor verá após analisar o JSON. A indentação fora das aspas apenas facilita a leitura do JSON; ela não altera essa string.
Para uma legenda de duas linhas, a terceira versão costuma ser a mais útil. Para uma frase quebrada em duas linhas em um arquivo de configuração, a quarta mantém tudo junto sem uma nova linha final.
Escolha o estilo do bloco e o final separadamente
| Marcador YAML | Entre linhas de texto comuns | No final desta amostra |
|---|---|---|
| |
Mantém uma nova linha | Mantém uma nova linha final |
> |
Dobra a quebra em um espaço | Mantém uma nova linha final |
|- |
Mantém uma nova linha | Remove a nova linha final |
>- |
Dobra a quebra em um espaço | Remove a nova linha final |
Essas regras descrevem blocos não vazios como esta amostra. O YAML chama a regra de final de “chomping”; a especificação de escalares em bloco também define um sinal de mais para reter linhas vazias finais.
A dobra não apaga toda quebra de linha. Linhas em branco e linhas mais indentadas têm regras próprias. Faça um teste pequeno antes de converter uma mensagem, um prompt ou um comando de shell cujo espaçamento importa.
Uma linha em branco ainda separa parágrafos
Este exemplo usa texto dobrado, mas inclui uma linha em branco:
paragraphs: >-
First paragraph.
Second paragraph.
O valor convertido é:
{
"paragraphs": "First paragraph.\nSecond paragraph."
}
Há uma nova linha entre os dois parágrafos, não um espaço e não duas novas linhas. Se você precisar de linhas em branco exatas, use um bloco literal e verifique a string resultante.
Indente o conteúdo do bloco com espaços sob sua chave. Mover uma linha para a esquerda pode encerrar o bloco ou tornar o documento inválido. Um documento quebrado deve ser corrigido na origem, em vez de ser “consertado” removendo todos os espaços em branco.
Mantenha o YAML se comentários importarem
Baixe a amostra YAML completa e seu JSON convertido. A amostra inclui todos os cinco casos acima.
A conversão preserva os valores interpretados, não a apresentação original do YAML. Comentários, marcadores de estilo de bloco e notação de alias não são preservados em JSON. Mantenha o YAML original se você for editar a configuração novamente; convertê-lo de volta não restaurará esses detalhes.
Em 12 de outubro de 2026, executamos o arquivo para download pela função de conversão da ferramenta e verificamos cada string, incluindo sua nova linha final. O arquivo de resultados registra os valores esperados e os hashes de download. A ferramenta converte localmente no seu navegador, mas você ainda deve usar uma amostra sanitizada ao compartilhar uma configuração com outra pessoa.