Este guia explica como criar um link direto para um título dentro de uma publicação ou tópico do Discourse, permitindo que os usuários naveguem eficientemente por publicações longas.
Nível de usuário necessário: Todos os usuários
Adicionar títulos dentro de publicações longas pode tornar o conteúdo mais legível e permitir que os usuários criem links diretos para seções específicas. Isso pode ser particularmente útil para navegar em discussões e documentações extensas.
Resumo
Este guia abrange:
- Criação de títulos usando Markdown
- Criação de links diretos para títulos específicos em uma publicação
Criação de títulos usando Markdown
Para criar um título no Markdown, prefixe uma linha de texto com um ou mais caracteres #. O número de caracteres # corresponde ao nível do título. Aqui estão alguns exemplos:
## Este é um título de nível 2
Aqui está um pequeno parágrafo depois.
### Este é um título de nível 3
Aqui está outro parágrafo curto.
Quando renderizado, fica assim:
Este é um título de nível 2
Aqui está um pequeno parágrafo depois.
Este é um título de nível 3
Aqui está outro parágrafo curto.
Criação de links diretos para um título
Para compartilhar um link direto para um título dentro de uma publicação:
- Passe o mouse sobre o título para revelar um ícone de link ao lado dele:
. - Clique no ícone de link para atualizar a URL na barra de endereço do seu navegador com o link direto para aquele título.
- Copie a URL atualizada da barra de endereço para compartilhá-la com outras pessoas.
O ícone de link só aparece em dispositivos desktop (não touch) ao passar o mouse sobre um título. Em dispositivos touch e móveis, os links âncora existem na página, mas não estão visíveis.
Entendendo as URLs âncora dos títulos
Quando você clica no ícone de link de um título, a URL na barra de endereço é atualizada com um fragmento no formato:
#p-{postId}-{slugified-heading}-{number}
Por exemplo, um título “Getting Started” na publicação 12345 produziria um fragmento de URL como #p-12345-getting-started-1. O número no final é um contador sequencial baseado na posição do título na publicação.
Melhores práticas
- Use títulos descritivos para resumir o conteúdo claramente.
- Estruture sua publicação usando títulos hierárquicos onde for apropriado.
- Garanta que os títulos sejam consistentes e lógicos para melhor legibilidade.
- Esteja ciente de que editar o texto do título ou reordenar os títulos mudará seus URLs âncora, o que pode quebrar links existentes.
Perguntas Frequentes (FAQs)
Posso criar um link para qualquer parte de uma publicação?
Você pode criar um link para qualquer título formatado corretamente em Markdown, desde que não esteja dentro de um bloco de citação ou bloco de citação. Títulos dentro desses blocos não geram links âncora.
Os links para títulos funcionam em publicações diferentes?
Sim! Esses links direcionarão para o título na publicação quando usados em outros tópicos ou compartilhados em outro lugar.