Skip to content

Grátis · Privado · Sem registo

Linha horizontal markdown — copie uma régua que renderiza mesmo

Um clique para copiar ---, *** ou ___, mais as três regras que decidem se a sua régua horizontal renderiza ou se torna um título, uma lista ou texto a negrito.

Dash remover tool

Everything happens in your browser. Your text never leaves this page.

Dashes to remove
Replace each dash with
Cleanup options

Press Ctrl (or ⌘) + Enter to run it again.

Cleaned text

0dashes removed

A linha horizontal — o <hr> do HTML, a «quebra temática» da especificação CommonMark — é o markdown na sua forma mais mínima: três caracteres numa linha, sozinhos. É também o markdown na sua forma mais traiçoeira, porque as três grafias comportam-se de forma diferente em má companhia. --- diretamente sob uma linha de texto não é uma régua: promove esse texto a título H2. *** num parser errado pode ler-se como ênfase. E uma régua dentro de um item de lista não é uma régua — é texto da lista.

As três formas acima são o que a especificação chama de equivalentes: --- (hífenes), *** (asteriscos) e ___ (sublinhados), cada uma na sua própria linha, cada uma com uma linha em branco acima e abaixo. Copie a que serviu ao seu documento. Se colar réguas sob parágrafos com regularidade, a forma de asteriscos é o hábito que vale a pena criar — nenhum motor de markdown a pode confundir com um título setext, seja como for que o documento acima termine.

Cada variante é uma string de texto real, não uma imagem: cole-a num README, num post do Jekyll, numa mensagem do Discord ou num gerador de sites estáticos e renderiza como a mesma régua em todo o sítio onde se fala markdown. Os cartões abaixo cobrem as três regras de sintaxe que decidem se funciona, porque «como fazer uma linha horizontal em markdown» são realmente três perguntas: que caracteres, quantos, e o que deve cercá-los.

As três réguas horizontais

Mesma saída, modos de falha diferentes. Clique num cartão para copiar a marcação.

As três regras que a fazem renderizar

Três caracteres ou mais

--- exato funciona, e ---------- também. Menos do que isso é apenas texto. A convenção habitual é três.

Uma linha em branco acima

Texto, depois ---, torna o texto um título e a régua desaparece. Deixe sempre uma linha vazia entre o parágrafo e a régua.

Nada além dos caracteres

Espaços entre os sinais são permitidos ( - - - ), mas qualquer outro texto na linha — incluindo um item de lista — muda o significado.

EscreveObtém
Texto\n---Um título H2 — não uma régua.
Texto\n\n---A régua horizontal pretendida.
- item\n---Um título — o marcador de lista muda o significado.
- item\n\n---A régua horizontal pretendida.
- - -Uma régua — espaços entre os sinais são permitidos.
--Texto simples: dois hífenes não chegam.

O mesmo hífen que constrói réguas markdown é o carácter que este site remove: se chegou um rascunho cheio de separadores --- que não queria, oremovedor de todos os traçostira a família inteira, e areferência da linha horizontal markdownestá sempre aqui quando precisar de uma de volta.

Perguntas

Como faço uma linha horizontal em markdown?
Coloque três hífenes (---), asteriscos (***) ou sublinhados (___) ou mais numa linha só deles, com uma linha em branco acima e abaixo. As três renderizam como a mesma régua horizontal — o elemento <hr> do HTML.
Porque é que o meu --- transforma a linha de cima em título?
Porque uma linha de texto seguida imediatamente de --- é a sintaxe setext de um título H2, não uma régua. É a surpresa markdown mais comum. Deixe uma linha em branco entre o texto e os hífenes — ou use ***, que não pode ser mal interpretado.
O <hr> é markdown válido?
Sim — HTML cru é permitido em markdown e o <hr> (ou <hr />) renderiza como régua em todos os motores principais. É a saída de emergência quando a sintaxe nativa se porta mal, mas as formas de três caracteres são mais portáveis e sobrevivem melhor às idas e voltas entre editores.
Qual é a diferença entre --- e ***?
No resultado, nenhuma — ambos tornam-se no mesmo <hr>. No comportamento, uma coisa: --- sob um parágrafo torna esse parágrafo um título, enquanto *** renderiza sempre como régua. Essa assimetria é a razão pela qual as guias de estilo que se importam escolhem uma e documentam-na.
Quantos caracteres precisa uma régua?
Três ou mais — ---------- é tão válida como ---. Espaços entre os caracteres são permitidos ( - - - renderiza), mas qualquer outra coisa na linha (texto, marcador de lista) muda completamente o significado.
Posso estilizar a linha horizontal?
Não com o markdown. A régua torna-se um <hr> em HTML, por isso a ferramenta é CSS: hr { border: 0; border-top: 1px solid #ccc; } é o restyling clássico. Nas plataformas que não controla, a régua renderiza como o stylesheet deles decidir.

Pronto para limpar o seu texto?

Sem registo, sem uploads e sem limite de palavras. Cole, escolha e copie o resultado.

Limpar o texto agora

Ferramentas de riscas relacionadas

O hífen usa muitos chapéus. O resto do guarda-roupa vive aqui.