Como fazer uma quebra de linha em Markdown:dois espaços, uma barra invertida ou uma etiqueta br.

Porque é que o Markdown ignora a sua nova linha

O Markdown junta as linhas de um parágrafo. Se escrever

Roses are red
Violets are blue

o leitor vê um só parágrafo, As rosas são vermelhas As violetas são azuis. A mudança de linha no código-fonte é uma quebra suave: um sítio onde partiu o texto, e não onde o leitor deve ver uma quebra. Permite-lhe partir linhas longas no editor sem alterar o aspeto da página.

Uma linha em branco é diferente. Termina o parágrafo e começa um novo, com espaço entre os dois. Na maioria das vezes é a quebra que quer.

Três formas de forçar uma quebra de linha

Uma quebra de linha forçada, chamada quebra rígida, mantém o texto no mesmo parágrafo e começa a linha seguinte.

1. Dois espaços no fim da linha

   Escreva pelo menos dois espaços antes de premir Enter. Funciona em todo o lado, mas os espaços não se veem, e alguns editores e definições do Git eliminam-nos.

2. Uma barra invertida no fim da linha

   Ponha \ como último carácter, sem espaço a seguir. É visível e sobrevive à remoção de espaços. Faz parte do CommonMark e do GitHub Flavored Markdown, embora algumas aplicações mais antigas não a conheçam.

3. Uma etiqueta HTML br

   Termine a linha com <br> (ou <br/>). Funciona em quase todas as aplicações que aceitam HTML em linha. É também a única forma de quebrar uma linha dentro de uma célula de tabela.

Two spaces after this line  
comes out on a new line.

A backslash ends this one\
and breaks it too.

A tag also works.<br>
Third line.

As três dão o mesmo resultado:

Dois espaços depois desta linha
passam para uma nova linha.

Qual deve usar?

• Um novo parágrafo (linha em branco) para tudo o que seja uma ideia separada. É a escolha mais portátil.
• Uma barra invertida quando precisa de uma quebra a meio de um parágrafo, como numa morada ou num poema, e a aplicação segue o CommonMark.
• Uma etiqueta br numa célula de tabela, ou quando não tem a certeza de que a aplicação suporta as outras duas.
• Dois espaços só quando tem a certeza de que nada os vai eliminar.

As quebras não funcionam dentro de um trecho de código, e uma quebra mesmo no fim de um parágrafo não faz nada. Se quiser espaço em branco, use uma linha em branco ou um título, e não uma pilha de etiquetas <br>.

Exemplos: uma morada, um poema, um item de lista

Uma quebra rígida convém ao texto em que a própria linha conta, como uma morada postal:

Jane Smith221B Baker StreetLondon

Maria Silva
Rua Augusta, 120
1100-053 Lisboa

Dentro de um item de lista, termine a linha com a quebra e indente a linha seguinte para ficar alinhada com o texto do item:

- Pack the bags  and lock the door
- Leave at eight

Se todas as linhas de um texto longo precisam de uma quebra, o texto é provavelmente uma lista ou um bloco de código, e o Markdown tem sintaxe para ambos.

Quando a quebra de linha continua a não funcionar

• Um só espaço no fim. Precisa de dois ou mais.
• Um espaço depois da barra invertida. A barra invertida tem de ser o último carácter da linha.
• O editor elimina os espaços finais ao guardar. Passe a uma barra invertida ou a uma etiqueta br.
• O mesmo texto parece diferente em dois sítios. Algumas aplicações, como as caixas de issues e comentários do GitHub, mantêm as mudanças de linha simples como quebras, enquanto um ficheiro Markdown no GitHub não. Uma quebra forçada tem o mesmo aspeto nos dois.
• Texto dentro de um item de lista ou de uma citação. Mantenha a quebra no fim da linha e depois indente a linha seguinte para acompanhar o item.

A verificação mais rápida é abrir o ficheiro num leitor. O DotMD segue estas regras: uma só mudança de linha junta as linhas, e dois espaços, uma barra invertida ou um <br> quebram a linha. A leitura é gratuita, e no DotMD Editor a pré-visualização em direto mostra o resultado à medida que escreve.

Perguntas sobre quebras de linha em Markdown

Mais perguntas