Como adicionar uma linha horizontal no Markdown
O guia completo para linhas horizontais em markdown. Aprenda como criar linhas horizontais no markdown para que tudo seja renderizado corretamente após a publicação.
Uma linha horizontal na marcação é uma das ferramentas de formatação mais simples, porém mais úteis disponíveis. Ele cria um divisor visual entre seções de conteúdo, tornando seus documentos mais fáceis de digitalizar e mais organizados. Esteja você escrevendo uma documentação, um arquivo README ou uma postagem de blog, saber como usar markdown para divisores de linhas horizontais melhorará a estrutura de sua escrita.
Este guia explica todos os métodos e aborda o comportamento específico da plataforma para que você possa usar linhas horizontais com segurança em qualquer lugar. Leia nossa folha de cheats do markdown para saber mais.
O que é uma linha horizontal no Markdown?
Uma linha horizontal, também chamada de regra horizontal ou quebra temática, é renderizada como uma linha fina que se estende por toda a largura da sua área de conteúdo. Em HTML, isso se traduz em uma tag <hr>. Os escritores o usam para separar tópicos, sinalizar uma mudança de tom ou dividir documentos longos em seções digeríveis.
Três maneiras de adicionar uma linha horizontal no Markdown
Markdown oferece três opções de sintaxe que produzem o mesmo resultado. Cada um requer três ou mais caracteres consecutivos em sua própria linha, sem outro conteúdo.
Hífens
---
Três hífens são a escolha mais popular. Eles são rápidos de digitar e visualmente limpos em arquivos markdown brutos.
Asteriscos
***
Três asteriscos funcionam de forma idêntica. Alguns escritores os preferem porque não há risco de criar acidentalmente um título, o que pode acontecer com hífens se o texto aparecer na linha diretamente acima.
Sublinhados
___
Três sublinhados são a terceira opção. Eles são menos usados, mas são totalmente suportados em todos os analisadores de redução padrão.
Você também pode usar mais de três caracteres se preferir um divisor mais visível em seu texto bruto:
----------
Isso é renderizado exatamente da mesma maneira que três hífens.
Um erro comum ao adicionar redução de linha horizontal
Um dos erros mais frequentes é colocar três hífens diretamente abaixo de uma linha de texto, sem uma linha em branco entre eles. Ao fazer isso, a maioria dos analisadores interpreta o texto acima como um título, em vez de um parágrafo seguido por uma linha horizontal.
Por exemplo, isso cria um título em vez de uma divisória:
Some text
---
Para evitar isso, deixe sempre uma linha em branco antes da régua horizontal:
Some text
---
Isso garante que o analisador os trate como dois elementos separados.
Linha horizontal de marcação do GitHub
Se você trabalha com GitHub, encontrará linhas horizontais frequentemente em arquivos README, descrições de pull request e páginas wiki. Todas as três opções de sintaxe funcionam na marcação do GitHub. O uso de linha horizontal na marcação do GitHub segue a especificação CommonMark, portanto, o comportamento é previsível e consistente.
Um caso de uso típico em um README do GitHub pode ser assim:
## Features
List of features here.
---
## Installation
Installation steps here.
A linha horizontal na marcação do GitHub fornece uma quebra visual clara entre as seções principais, sem depender apenas de títulos.
Linha horizontal de marcação de discórdia
O Discord oferece suporte a um subconjunto limitado de descontos em mensagens de bate-papo, mas as linhas horizontais não são um dos recursos suportados. Se você tentar digitar --- ou *** em uma mensagem do Discord, o aplicativo não renderizará uma regra horizontal. Em vez disso, ele pode exibir os caracteres como texto simples ou interpretar os asteriscos como formatação em negrito/itálico.
Para contornar a falta de uma linha horizontal de marcação do Discord, muitos usuários criam divisórias visuais usando caracteres repetidos ou emoji:
─────────────────
Este não é um desconto verdadeiro, mas tem o mesmo propósito visual nas conversas do Discord.
Quando usar uma linha horizontal no Markdown
As linhas horizontais funcionam melhor em situações específicas. Use-os para separar o cabeçalho de um documento ou bloco de metadados do conteúdo principal, para dividir seções não relacionadas em um único documento ou para marcar uma transição na narrativa ou no tópico. Eles também são úteis em arquivos README longos, onde várias seções principais se beneficiam de limites visuais fortes.
Evite usá-los em excesso. Se cada seção do seu documento for separada por uma linha horizontal, o efeito perde o impacto e o documento pode parecer instável. Os títulos por si só são geralmente suficientes para a maioria das necessidades estruturais, com linhas horizontais reservadas para quebras mais significativas.
Linhas horizontais e matéria frontal
Se você usar geradores de sites estáticos como Jekyll, Hugo ou Astro, notará que --- também serve como delimitador para blocos de front-matéria na parte superior dos arquivos markdown:
---
title: My Blog Post
date: 2026-05-11
---
Content starts here.
O analisador distingue entre questões frontais e regras horizontais com base na posição. Os hífens triplos no início de um arquivo abrem um bloco frontal, enquanto os mesmos caracteres em outras partes do documento criam uma linha horizontal. Tenha isso em mente para não quebrar acidentalmente o assunto inicial adicionando linhas --- extras perto do topo do seu arquivo.
Referência rápida
Aqui está um resumo de todas as maneiras de adicionar uma linha horizontal na marcação:
---(três hífens) é a sintaxe mais comum e amplamente suportada.***(três asteriscos) funciona de forma idêntica e evita a criação acidental de títulos.___(três sublinhados) é totalmente suportado, mas menos comumente usado.- Sempre deixe uma linha em branco acima da régua horizontal para evitar que ela seja interpretada como um título.
- Todos os três métodos funcionam na redução do GitHub.
- Discord não oferece suporte nativo a linhas horizontais de redução.
Considerações Finais
Aprender a adicionar uma linha horizontal na redução leva apenas um momento, mas usá-la bem requer um pouco de julgamento. Escolha um estilo de sintaxe, mantenha a consistência em todos os seus documentos e lembre-se de incluir uma linha em branco acima da regra para evitar surpresas de formatação. Com esses princípios básicos implementados, seus documentos de redução serão mais limpos, mais legíveis e mais bem organizados.