Quebras de linha em Markdown: novas linhas, parágrafos e células

Para iniciar uma nova linha dentro de um parágrafo Markdown, coloque uma barra invertida no final da primeira linha e pressione Enter. Para iniciar outro parágrafo, deixe uma linha em branco. Essas opções produzem estruturas diferentes no documento, o que importa quando você exporta posteriormente um README, endereço ou relatório para Word.

Equipe de documentação\
Rua Exemplo, 42\
Portland, Oregon

O endereço permanece em um único parágrafo exibido em três linhas. Cole-o na prévia de Markdown para comparar com os exemplos abaixo.

Escolha o tipo de quebra necessário

Resultado desejado	Código Markdown	Uso comum
Continuar o mesmo parágrafo	Uma quebra de linha comum	Dividir linhas longas no arquivo-fonte
Iniciar outra linha no mesmo parágrafo	Barra invertida seguida de Enter	Endereços e versos curtos
Iniciar um novo parágrafo	Uma linha em branco	Separar ideias em um artigo
Quebrar a linha dentro de uma célula	`<br>` onde houver suporte a HTML	Dois rótulos curtos em uma célula

Uma quebra de linha não cria uma quebra de página. Se a próxima seção precisar de uma nova folha no documento exportado, consulte o guia de quebras de página em Markdown.

Por que pressionar Enter pode parecer um espaço

Experimente este código:

O rascunho está pronto.
A pessoa responsável pela revisão pode abri-lo hoje.

Na prévia deste site, ambas as frases pertencem ao mesmo parágrafo e aparecem em sequência. A quebra continua útil no arquivo-fonte, mas não obriga o navegador a iniciar uma nova linha na tela. O navegador ainda pode ajustar o texto de acordo com a largura disponível.

Agora insira uma linha vazia:

O rascunho está pronto.

A pessoa responsável pela revisão pode abri-lo hoje.

A prévia produz dois parágrafos. Use essa versão quando a segunda frase iniciar uma nova ideia. Adicionar várias linhas vazias não é uma forma confiável de solicitar mais espaço vertical; o estilo dos parágrafos depende do renderizador ou do modelo de documento.

Barra invertida ou dois espaços no final

O CommonMark define tanto dois espaços antes de uma quebra de linha quanto uma barra invertida antes da quebra como sintaxe de quebra forçada dentro de um parágrafo. Os exemplos de quebras de linha forçadas do CommonMark documentam as duas formas.

A versão com barra invertida fica visível durante a revisão de um arquivo:

Preparado pela equipe de documentação\
Revisado pela pessoa responsável pela versão

A alternativa é digitar exatamente dois espaços depois de documentação e pressionar Enter. Esses espaços são invisíveis em muitos editores e podem ser removidos pela limpeza automática de espaços no final das linhas. Se uma quebra desaparecer após salvar, verifique as configurações de espaços em branco ou use a barra invertida.

Não digite os dois caracteres \n em um texto comum esperando uma quebra. Essa é uma convenção de strings de programação, não uma nova linha Markdown. Também evite colocar uma barra invertida no final de um parágrafo: uma quebra forçada precisa de outra linha de conteúdo do mesmo parágrafo em seguida.

Comentários do GitHub e arquivos README se comportam de maneiras diferentes

A documentação de quebras de linha do GitHub distingue os arquivos .md de repositórios das issues, pull requests e discussões. Quebras comuns podem aparecer como quebras de linha nessas áreas de conversa, enquanto um README precisa da sintaxe explícita de quebra forçada.

Essa diferença explica por que um texto copiado de uma issue pode parecer diferente em um README. Revise o arquivo de destino em vez de presumir que todas as áreas de um mesmo site usam regras de formatação idênticas.

Mantenha a continuação dentro de um item da lista

Recue a continuação para alinhá-la ao início do texto do item:

- Notas da versão\
  Inclua as instruções de migração.
- Guia de instalação

Aqui, o primeiro item aparece em duas linhas. O segundo permanece separado. Para incluir um parágrafo separado dentro do primeiro item, use uma linha em branco e mantenha o recuo da continuação:

- Notas da versão

  Inclua as instruções de migração e os problemas conhecidos.
- Guia de instalação

O guia de recuo aborda listas numeradas, marcadores aninhados e código dentro de um item.

Adicione uma nova linha em uma célula de tabela Markdown

Uma linha de tabela GFM deve ocupar uma única linha do arquivo-fonte. Pressionar Enter dentro do conteúdo pode dividir a linha da tabela. Em renderizadores que permitem quebras de linha HTML, use este padrão:

| Documento | Responsáveis |
| --- | --- |
| Notas da versão | Redator<br>Revisor |

A prévia deste site aceita esse exemplo. Um destino que remova HTML pode eliminar a quebra ou mostrar a tag, então verifique a plataforma antes de adotar o padrão em todo o documento. Uma lista fora da tabela costuma ser mais fácil de manter quando uma célula precisa de vários parágrafos.

Use o gerador de tabelas Markdown para dados tabulares e o guia de sintaxe de tabelas para alinhamento e barras verticais escapadas.

Confira o documento exportado

Antes de usar o conversor de Markdown para Word, teste um pequeno trecho com uma quebra de linha comum, uma quebra forçada explícita e uma linha em branco. A prévia deve mostrar, respectivamente, um parágrafo contínuo, uma quebra de linha forçada e dois parágrafos separados.

Abra o DOCX baixado e inspecione o endereço, as listas e a tabela. A largura da página e os estilos de parágrafo do Word podem alterar o ajuste de linhas mesmo quando as quebras subjacentes estão corretas. Corrija primeiro a estrutura Markdown; ajuste a tipografia final no Word quando um modelo específico de documento exigir.