Markdown Quebras duras e suaves
Última atualização: 2026-10-14
Quebras duras e suaves Núcleo CommonMark
No código-fonte, um único Enter é uma quebra suave, renderizada como espaço (mesclada no mesmo parágrafo); dois espaços no fim da linha ou uma barra invertida formam uma quebra dura, renderizada como <br>. O GitHub renderizar um Enter como <br> é dialeto da plataforma — não dependa disso entre plataformas.
| Grupo | Casos limite e regras |
|---|---|
| Nível de especificação | Núcleo CommonMark |
| Versão da especificação | CommonMark 0.31.2 + GFM |
📝 Sintaxe
Quebra suave = um único Enter
Quebra dura = dois espaços no fim da linha ou \▶ Exemplo interativo
Edite o Markdown à esquerda e veja o resultado à direita
💡 Destaques
ℹ️ Note Issues e READMEs do GitHub renderizam um Enter como <br>, mas o CommonMark estrito gera um espaço — os dois comportamentos existem.
⚠️ Warning Espaços no fim da linha ficam invisíveis no git diff; em revisões de PR, quebras duras podem ser apagadas sem querer — recomenda-se a barra invertida.
❓ Perguntas frequentes
P Por que em algumas plataformas o Enter já quebra a linha?
R Dialeto de plataforma: fóruns GFM, Discord e afins renderizam um Enter como <br> — comportamento fora da especificação.
P Entre as duas formas de quebra dura, qual é recomendada?
R A barra invertida — não teme o trim de espaços no fim da linha feito pelo editor e fica visível no diff.
P Qual a vantagem de a quebra suave virar espaço?
R Sentenças longas em inglês podem ser quebradas em qualquer largura de coluna, e a saída mantém os espaços naturais.
📚 Itens relacionados
Quebras de linhaNúcleo CommonMark Continuação preguiçosaNúcleo CommonMark