Generatore di link Markdown

Le quattro varianti di link

Inline, senza titolo:

[Leggi la documentazione](https://example.com/docs)

Inline con titolo (tooltip al passaggio del mouse):

[Leggi la documentazione](https://example.com/docs "Documentazione completa")

Stile riferimento (URL definito qui sotto):

Apri la [documentazione][docs] o il [registro delle modifiche][cl].

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

Autolink (l’URL è sia testo che obiettivo):

<https://example.com>

Quando scegliere quale

• Inline per link occasionali dove l’URL è breve e il paragrafo è ancora leggibile.
• Stile riferimento quando citi lo stesso URL più volte, o quando l’URL è un mostro di tracciamento di 200 caratteri che altrimenti interromperebbe il flusso del paragrafo.
• Autolink per “ecco la nostra pagina di documentazione” dove vuoi letteralmente che l’URL sia visibile sia come testo che come obiettivo.

Igiene dei caratteri speciali

• Spazi negli URL devono essere %20 o il link si interrompe allo spazio.
• Parentesi nell’URL devono essere codificate in URL come %28 e %29, altrimenti il parser Markdown le mangia.
• Parentesi quadre nel testo di ancoraggio devono essere sottoposte a escape come \[ e \] per evitare che il parser le tratti come sintassi di link annidati.

Suggerimenti per l’accessibilità

• Evita “clicca qui”. Testo di ancoraggio come clicca qui o leggi di più è inutile quando gli utenti di lettori di schermo navigano tra i link. Usa testo descrittivo: [guida all'installazione](...).
• Non mettere l’URL stesso come testo di ancoraggio per URL lunghi, è ostile alla tecnologia assistiva e brutto in stampa.
• Apri in una nuova scheda è HTML raw (target="_blank"), non Markdown. La maggior parte dei renderer che accettano HTML raw lo rispetteranno; il puro CommonMark no.

Scorciatoia in una riga

Nei commenti di GitHub, incollare un URL accanto a un testo selezionato lo converte automaticamente in un link Markdown. Utile quando sei già nell’editor.