Linha horizontal no Markdown: separadores, regras e correções comuns

Para adicionar uma linha horizontal no Markdown, coloque três hífens em uma linha própria, com uma linha em branco acima e abaixo:

Fim da primeira seção.

---

Início da próxima seção.

O resultado é um separador entre dois parágrafos. Markdown o chama de quebra temática; HTML o representa com <hr>. Cole o exemplo no visualizador de Markdown para conferir o documento renderizado.

Três maneiras de escrever um separador

Todas estas formas produzem uma quebra temática:

Código Markdown	Resultado
---	Linha horizontal
***	Linha horizontal
___	Linha horizontal
* * *	Linha horizontal

Use pelo menos três hífens, asteriscos ou sublinhados do mesmo tipo. Espaços entre os marcadores são permitidos. Misturar tipos, adicionar texto na mesma linha ou usar apenas dois marcadores não cria uma linha. Essas regras de sintaxe vêm da especificação de quebras temáticas do CommonMark.

O número de hífens não controla a largura visual da linha. Uma sequência de 20 hífens e uma de três produzem o mesmo elemento HTML; o estilo do destino determina sua aparência.

Por que minha linha horizontal virou um título?

Este código não coloca um separador abaixo de “Notas da versão”:

Notas da versão
---

Ele cria um título de nível dois. Hífens diretamente abaixo do texto de um parágrafo podem formar um título Setext, e essa interpretação tem prioridade sobre uma linha horizontal. Adicione uma linha em branco para separá-los:

Notas da versão

---

Para uma seção do documento, um título explícito costuma ser mais claro:

## Notas da versão

O processo de importação agora aceita arquivos CSV.

Use títulos Markdown para identificar seções. Use uma linha horizontal quando a própria transição for relevante, como ao separar uma carta de um apêndice.

Por que o separador aparece como texto simples?

Verifique o código ao redor da linha:

Sintoma	Causa provável	Correção
A prévia mostra --- em um bloco de código	Quatro espaços no início de um bloco independente ou um bloco delimitado não fechado	Remover o recuo ou fechar o bloco
A prévia mostra --	Apenas dois hífens	Usar três ou mais
Há texto ao lado dos marcadores	A linha contém outro texto	Colocar os marcadores em uma linha própria
A linha aparece como --- dentro de uma frase	Os marcadores estão entre crases	Remover as crases quando a intenção for criar um separador
O parágrafo anterior vira um título	Não há linha em branco acima de ---	Inserir uma linha em branco

No nível principal do documento, uma quebra temática aceita até três espaços iniciais. Dentro de listas, o recuo também determina a qual item o conteúdo pertence, então confira a lista ao redor em vez de remover todos os espaços.

Uma linha horizontal é diferente de uma quebra de linha

Um separador divide seções. Ele não apenas move as palavras seguintes para uma nova linha.

Para um endereço, use uma quebra de linha forçada:

120 Market Street\
San Francisco, CA

Para um novo parágrafo, deixe uma linha vazia. Para separar seções, use --- em uma linha independente. O guia de quebras de linha no Markdown explica espaços finais, barras invertidas e o comportamento diferente do GitHub em arquivos e comentários.

Colocar um separador dentro de uma citação

Mantenha o prefixo > em cada linha, incluindo o separador e as linhas vazias:

> Proposta original.
>
> ---
>
> Contexto adicional de quem fez a revisão.

O separador permanece dentro da citação. Remover > da linha pode encerrar a citação e mover o separador para o documento externo. Consulte os exemplos de citações para vários parágrafos e citações aninhadas.

Um separador de tabela não é uma linha horizontal

Esta linha pertence a uma tabela:

| Formato | Editável |
| --- | :---: |
| Markdown | Sim |

As barras verticais e os dois-pontos opcionais descrevem as colunas. Eles não inserem um separador de largura total. Use o gerador de tabelas Markdown para criar uma tabela, ou o conversor CSV para Markdown quando os dados já estiverem em uma planilha.

Linhas horizontais e documentos exportados

Uma quebra temática não é um comando de quebra de página. Um exportador PDF ou Word decide onde as páginas terminam com base em suas regras de layout e paginação. Não adicione mais hífens esperando que a próxima seção comece em uma nova página.

Em uma página web cujo CSS você controla, o <hr> gerado pode receber estilos na folha de estilos do site. Um serviço Markdown hospedado pode não permitir CSS personalizado. Confira o destino final ou o documento exportado, especialmente se o separador tiver um significado que precisa ser preservado na impressão.

Perguntas frequentes

Preciso de linhas em branco ao redor de uma linha horizontal?

CommonMark não as exige em todos os contextos, mas usá-las evita a ambiguidade comum de --- como título e facilita a leitura dos arquivos-fonte.

Posso usar uma tag HTML hr?

<hr> funciona em renderizadores que permitem HTML bruto. A sintaxe Markdown --- é mais adequada para um documento Markdown. O editor MD File Viewer remove as tags HTML fornecidas pelo usuário, enquanto a sintaxe de separador Markdown é renderizada normalmente.

Como mostro três hífens sem criar um separador?

Para um exemplo de sintaxe, escreva código em linha: `---`. Para texto comum em uma linha independente, escape o primeiro hífen: \---.

Para outros padrões comuns de formatação, mantenha a folha de referência Markdown por perto.