Collegamento a un'intestazione all'interno di un post o di un argomento

Documentazione Usando Discourse
1

:bookmark: This guide explains how to link directly to a heading within a Discourse post or topic, enabling users to navigate long posts efficiently.

:person_raising_hand: Required user level: All users

Adding headings within long posts can make the content more readable and allow users to link directly to specific sections. This can be particularly useful for navigating extensive discussions and documentation.

Summary

This guide covers:

  • Creating headings using Markdown
  • Linking directly to specific headings in a post

Creating headings using Markdown

To create a heading in Markdown, prefix a line of text with one or more # characters. The number of # characters corresponds to the heading level. Here are some examples:

## This is a level 2 heading
Here is a short paragraph afterwards.

### This is a level 3 heading
Here is another short paragraph.

When rendered, it looks like this:

This is a level 2 heading

Here is a short paragraph afterwards.

This is a level 3 heading

Here is another short paragraph.

Linking directly to a heading

To share a direct link to a heading within a post:

  1. Hover over the heading to reveal a link icon next to it: link icon.
  2. Click the link icon to update the URL in your browser’s address bar with the direct link to that heading.
  3. Copy the updated URL from the address bar to share it with others.

Best practices

  • Use descriptive headings to summarize content clearly.
  • Structure your post using hierarchical headings where appropriate.
  • Ensure that headings are consistent and logical for better readability.

FAQs

Can I link to any part of a post?
Yes, as long as it’s a heading properly formatted in Markdown.

Do links to headings work across different posts?
Yes! These links will direct to the header in the post when used in other topics or shared somewhere else.

Additional resources

Last edited by @JammyDodger 2024-07-09T11:12:13Z

Last checked by @hugh 2024-08-08T01:48:04Z

Check documentPerform check on document:
73 Mi Piace
51

Non vedo le icone dei link su questo sito o sul mio. N
Né in FF né in Chrome.

È cambiato qualcosa?

52

Devi passare il mouse sopra l’intestazione affinchĂ© appaiano:

image
image327×196 4.72 KB

53

Passo il mouse sopra e non vedo nulla.

Sembra esserci qualcosa, ma non viene visualizzata alcuna icona.

Una domanda di follow-up


Presumo che se si cambia il testo dell’intestazione, il link si interromperà.

MODIFICA PER AGGIUNGERE: Non solo l’ancora cambia se il titolo cambia, ma se si inserisce un’altra intestazione prima delle intestazioni esistenti, il suffisso numerico sull’intestazione cambia. Questo sembra fragile al punto da essere inutile.

L’unica soluzione sicura sarebbe racchiudere le intestazioni in tag a html e assegnare loro un id, corretto?

Modifica di nuovo per aggiungere: Ho provato sia a racchiudere il testo dell’intestazione in tag a che a inserire tag vuoti prima del testo dell’intestazione. Nessuno dei due id ha funzionato. Ho anche provato con i tag span con lo stesso fallimento.

54

SĂŹ, posso trovarlo nel DOM come before:

image
image2842×1070 482 KB

Sono su Windows 11.

L’unico modo in cui riesco a far apparire l’icona del link ù copiando il link e poi aprendo quel link (con il # e l’id) in una nuova scheda e andando lì. Quindi l’icona del link viene visualizzata a tempo pieno (senza passaggio del mouse), ma comunque, nessuna delle altre icone del link apparirà al passaggio del mouse.

55

Posso rilanciare questo? Mi chiedo se mi sto perdendo qualcosa di ovvio riguardo al collegamento all’interno di un post.