Voltar ao blog

Como adicionar uma quebra de linha no Markdown

O guia completo para quebras de linha de redução. Aprenda como criar novas linhas e quebras de linha no markdown para que tudo seja renderizado corretamente após a publicação.

Benjamin McBrayer // Publicado: 11 de maio de 20264 min de leitura

As quebras de linha ajudam a controlar onde o texto começa em uma nova linha no Markdown. Eles são úteis para escritores, blogueiros, estudantes e qualquer pessoa que crie conteúdo online, porque tornam o texto mais fácil de ler e organizar. Este guia mostrará como as quebras de linha funcionam no Markdown e como usá-las corretamente. Ele cobre todos os métodos para que você possa formatar seu texto e adicionar uma quebra de linha na marcação exatamente da maneira que desejar.

Como adicionar uma quebra de linha no Markdown

Markdown é uma linguagem de marcação leve usada em plataformas como GitHub, Reddit, Notion e inúmeras ferramentas de documentação. Uma das perguntas mais comuns que as pessoas novas no markdown enfrentam é como criar uma quebra de linha no markdown, porque simplesmente pressionar a tecla Enter uma vez nem sempre faz o que você esperaria.

Por que pressionar Enter apenas para quebras de linha não funciona

Se você está tentando adicionar uma quebra de linha no markdown pressionando Enter, provavelmente já descobriu isto: uma única tecla de retorno geralmente é ignorada. Os analisadores Markdown normalmente tratam uma única nova linha como um espaço. Isto tem o efeito de fundir duas linhas em um parágrafo contínuo.

Como fazer uma quebra de linha no Markdown com espaços à direita

A maneira mais tradicional de adicionar uma quebra de linha no markdown é colocar dois ou mais espaços no final de uma linha antes de pressionar Enter. Isso produz um elemento <br> no HTML renderizado.

This is the first line.··
This is the second line.

(Os pontos representam espaços.)

O resultado é uma quebra de linha suave onde ambas as linhas aparecem no mesmo bloco de parágrafo, mas em linhas separadas. Esta é muitas vezes a solução mais rápida, embora os espaços sejam invisíveis e fáceis de perder durante a edição.

Como fazer uma quebra de linha no Markdown com uma barra invertida

Muitos analisadores modernos também suportam uma barra invertida como caractere de quebra de linha:

This is the first line.\
This is the second line.

Essa abordagem resolve o problema de visibilidade de espaços finais e é suportada por CommonMark, GitHub Flavored Markdown e várias outras especificações populares. Se você preferir uma sintaxe explícita e legível, a barra invertida é uma ótima opção.

Como adicionar uma nova linha no Markdown com HTML

Como o Markdown suporta HTML embutido, você sempre pode usar uma tag <br> bruta para iniciar uma nova linha no markdown:

This is the first line.<br>
This is the second line.

Este é o método mais explícito e funciona em praticamente todos os analisadores. É especialmente útil dentro de tabelas ou outros contextos onde espaços e barras invertidas podem não ser reconhecidos.

Como criar uma quebra de linha no Markdown usando uma linha em branco

Se você precisar de mais separação visual do que uma simples quebra de linha, deixar uma linha em branco entre dois blocos de texto criará uma quebra de parágrafo completa:

This is the first paragraph.

This is the second paragraph.

Embora seja tecnicamente uma quebra de parágrafo em vez de uma quebra de linha, é a resposta que muitas pessoas realmente procuram quando desejam adicionar quebras de linha na redução. O espaço entre os parágrafos é maior, o que o torna ideal para separar ideias distintas.

Como quebrar linha em tabelas Markdown

As tabelas merecem uma menção especial porque são um dos locais mais complicados para lidar com quebras de linha. Como o caractere de barra vertical (|) define colunas e cada linha deve ficar em uma única linha, espaços à direita e barras invertidas geralmente não ajudam. A tag <br> é a abordagem mais confiável aqui:

| Feature | Description |
|---------|-------------|
| Speed   | Very fast<br>Even under load |

Tenha isso em mente sempre que precisar quebrar uma linha dentro de elementos estruturados.

Referência rápida

Aqui está um resumo de cada método para fazer uma quebra de linha na redução:

  • Dois espaços à direita + Enter funciona em qualquer lugar e é a abordagem clássica, mas os espaços são invisíveis.
  • Barra invertida + Enter é visível e limpa, suportada por analisadores baseados em CommonMark.
  • A tag <br> funciona em qualquer lugar, inclusive dentro de tabelas.
  • Uma linha em branco cria uma quebra de parágrafo completa em vez de uma simples nova linha na redução.

Dicas Finais

Ao decidir como adicionar quebras de linha na redução, considere sua plataforma e público-alvo. Se sua equipe colabora no GitHub, o método de barra invertida mantém as diferenças limpas. Se você estiver escrevendo documentação renderizada por um analisador menos comum, a tag HTML <br> é a aposta mais segura. E se os espaços finais são sua preferência, configure seu editor para mostrar espaços em branco para que você nunca os perca acidentalmente.

Agora que você sabe como quebrar linhas no markdown usando todos os métodos disponíveis, a formatação do seu texto deve parecer muito menos imprevisível. Escolha o método que se adapta ao seu fluxo de trabalho, mantenha a consistência e seus documentos serão renderizados exatamente da maneira que você deseja.