Como pular linha no Markdown: 3 métodos que funcionam

Você escreveu duas linhas no seu arquivo Markdown, pressionou Enter entre elas e no resultado final as duas aparecem grudadas numa só linha. Isso não é bug, é comportamento padrão da linguagem.

No Markdown, um único Enter é interpretado como um espaço, não como uma quebra de linha. Para realmente separar duas linhas no mesmo parágrafo, você precisa usar um dos três métodos abaixo. Cada um tem uma forma de escrever diferente e comportamentos distintos dependendo do editor ou plataforma que você usa.

Por que o Enter sozinho não funciona

Markdown foi criado para que o texto seja legível tanto no formato bruto quanto depois de renderizado. Por isso, um Enter simples é tratado como continuidade do parágrafo, igual a um espaço entre palavras.

Dois Enters consecutivos criam um novo parágrafo, com espaçamento maior entre os blocos de texto. Se você quer apenas uma quebra de linha dentro do mesmo parágrafo, como acontece em endereços, versos ou listas sem marcadores, precisa de uma das abordagens abaixo.

Método 1: dois espaços no final da linha

O método original da especificação Markdown: adicione dois espaços ao final da linha antes de pressionar Enter. O resultado é uma quebra de linha simples, sem criar um novo parágrafo.

Primeira linha  
Segunda linha

O problema prático é que esses dois espaços são invisíveis no editor. Muitos editores de texto e ferramentas de formatação automática removem espaços em branco no final das linhas, o que faz esse método deixar de funcionar silenciosamente. Se você usa Prettier, EditorConfig com trim_trailing_whitespace = true ou qualquer outra ferramenta de limpeza de código, os dois espaços serão apagados.

Quando usar: em editores simples onde você controla o arquivo diretamente, sem ferramentas de formatação automática.

Método 2: barra invertida no final da linha

Código HTML e CSS controlando quebras de linha

A barra invertida \ ao final de uma linha é reconhecida pelo CommonMark, que é a especificação que o GitHub, VS Code, Obsidian e muitos outros seguem. O resultado é idêntico ao dos dois espaços: uma quebra de linha sem novo parágrafo.

Primeira linha\
Segunda linha

Esse método tem uma vantagem sobre os dois espaços: é visível. Você consegue ver claramente onde a quebra de linha foi inserida. A desvantagem é que não faz parte da especificação Markdown original de John Gruber, então em processadores mais antigos ou não padronizados pode não funcionar.

Quando usar: em arquivos para GitHub, VS Code, Obsidian ou qualquer ferramenta baseada em CommonMark.

Método 3: a tag <br> no HTML

Markdown aceita HTML diretamente no corpo do texto em quase todas as implementações. A tag <br> é a forma mais confiável e portável de criar uma quebra de linha.

Primeira linha<br>
Segunda linha

Ou com tag de fechamento, que também funciona:

Primeira linha<br/>
Segunda linha

Esse é o método com maior compatibilidade. Funciona no GitHub, Jekyll, Hugo, Pandoc, MkDocs e na maioria das ferramentas que processam Markdown. A única exceção relevante é o Notion, que não renderiza tags HTML no corpo do texto do editor.

Quando usar: quando você precisa de compatibilidade máxima ou não tem certeza de qual processador Markdown vai renderizar o arquivo.

Comparação dos três métodos

MétodoSintaxeVisível no códigoCompatibilidade
Dois espaçoslinha··↵NãoAlta, mas frágil
Barra invertidalinha\↵SimCommonMark e derivados
Tag <br>linha<br>SimA mais ampla

Como cada plataforma se comporta

O mesmo Markdown pode se comportar de formas diferentes dependendo de onde ele é renderizado. Essa tabela ajuda a escolher o método certo para cada contexto.

PlataformaMelhor métodoObservação
GitHub (README, Issues, Wiki)\ ou <br>Dois espaços funcionam, mas <br> é mais seguro
VS Code (preview)Qualquer umOs três funcionam
Obsidian\ ou <br>CommonMark nativo
Jekyll / Hugo<br>Mais confiável em templates
NotionShift + EnterTags HTML não são renderizadas no Notion
Pandoc\ ou <br>Dois espaços funcionam, <br> mais portável
Jupyter Notebook<br>HTML é o mais confiável em células Markdown

Diferença entre quebra de linha e novo parágrafo

Essa distinção vale entender para usar o método certo.

Quebra de linha separa duas linhas dentro do mesmo bloco de texto, sem espaço visual extra entre elas. É o que os três métodos acima produzem.

Novo parágrafo cria um bloco separado com espaçamento maior entre os textos. Acontece quando você deixa uma linha em branco entre dois blocos.

Este é o primeiro parágrafo.

Este é o segundo parágrafo. Tem espaço visual antes dele.

Esta é a primeira linha de um parágrafo.<br>
Esta é a segunda linha do mesmo parágrafo, sem espaço extra.

Se você trabalha com HTML e quer entender como essa lógica funciona na linguagem de marcação da web, veja como fazer quebra de linha no HTML.

Perguntas frequentes

Por que meu Markdown não pula linha mesmo usando Enter?

Porque no Markdown, um Enter simples é tratado como espaço. Para criar uma quebra de linha visível dentro do mesmo parágrafo, use dois espaços no final da linha, uma barra invertida \ ou a tag <br>.

Qual a diferença entre quebra de linha e parágrafo no Markdown?

Quebra de linha mantém o texto no mesmo bloco, sem espaço visual extra entre as linhas. Novo parágrafo adiciona espaçamento maior e é criado com uma linha em branco entre os dois blocos de texto.

O método de dois espaços funciona no GitHub?

Sim, funciona. Mas na prática muitos arquivos têm os espaços no final das linhas removidos por ferramentas de formatação automática, o que quebra o método sem aviso. A barra invertida \ ou a tag <br> são mais confiáveis no GitHub.

A tag <br> funciona em todos os editores Markdown?

Na maioria sim, porque Markdown aceita HTML inline. A exceção mais comum é o Notion, que não renderiza tags HTML no corpo do texto. Para o Notion, o atalho nativo Shift + Enter é a forma correta de pular linha.

Shift + Enter funciona no Markdown?

Depende do editor. No Notion é o atalho nativo para quebra de linha. No VS Code, Shift + Enter pode inserir uma nova linha sem processar o Markdown. Em arquivos .md puros, Shift + Enter não tem efeito especial, a quebra de linha precisa ser marcada pela sintaxe.

Posso usar <br> no meio de uma lista Markdown?

Sim. A tag <br> funciona dentro de itens de lista na maioria dos processadores Markdown. É útil quando você quer separar informações dentro de um mesmo item sem criar um novo bullet.

Tela de computador com código HTML e a tag br destacada
Picture of Sara Lima
Sara Lima

Criadora do Meu Site Web e trabalha com criação de sites, WordPress e Elementor há mais de 8 anos. Jornalista por formação, une escrita e tecnologia para criar conteúdo prático sobre desenvolvimento web acessível a qualquer pessoa.

Últimos Posts