Torna al blog

Come sottolineare in Markdown

La guida completa alle sottolineature nel markdown. Scopri come sottolineare le parole e formattare le sottolineature nel markdown in modo che tutto venga visualizzato correttamente dopo la pubblicazione.

Benjamin McBrayer // Pubblicato: 11 maggio 20265 min di lettura

A differenza della formattazione in grassetto e corsivo, non esiste una sintassi di sottolineatura nativa incorporata nel linguaggio. Markdown è stato progettato per adattarsi perfettamente all'HTML e poiché il testo sottolineato viene facilmente confuso con i collegamenti ipertestuali sul Web, i creatori lo hanno intenzionalmente omesso.

Ciò non significa che sei sfortunato. Esistono diversi modi affidabili per sottolineare il markdown a seconda della piattaforma che stai utilizzando e del controllo che hai sull'output renderizzato.

Questa guida illustra tutti i metodi in modo da poter sottolineare il testo del markdown in qualsiasi situazione.

Perché Markdown non ha la sintassi di sottolineatura

Markdown è stato creato da John Gruber nel 2004 come un modo semplice per scrivere contenuti che si convertano in modo pulito in HTML. Il grassetto utilizza doppi asterischi, il corsivo utilizza asterischi singoli e il barrato utilizza tilde in alcuni gusti. Ma la sottolineatura è stata volutamente esclusa.

Il ragionamento è pratico. Sul Web, il testo sottolineato segnala quasi sempre un collegamento cliccabile. Se il markdown consentisse la sottolineatura nativa, i lettori confonderebbero costantemente le parole sottolineate con i collegamenti ipertestuali, creando un’esperienza confusa. La maggior parte delle guide di stile per i contenuti web scoraggiano anche la sottolineatura per lo stesso motivo.

Tuttavia, ci sono casi legittimi in cui è necessario sottolineare il testo nel markdown, come scritti accademici, documenti formali o piattaforme in cui i collegamenti hanno uno stile diverso.

Come sottolineare in Markdown utilizzando HTML

Il metodo più ampiamente supportato per sottolineare il testo di markdown consiste nell'utilizzare direttamente il tag HTML "":

This is <u>underlined text</u> in a sentence.

Questo viene visualizzato come: Questo è testo sottolineato in una frase.

Poiché la maggior parte dei parser di markdown consentono HTML in linea, questo approccio funziona su GitHub, GitLab, Jupyter Notebooks e molti generatori di siti statici. È la risposta più semplice per chiunque cerchi modi per creare una sintassi di sottolineatura del markdown, anche se tecnicamente utilizza HTML anziché il puro markdown.

Quando il tag <u> potrebbe non funzionare

Alcune piattaforme eliminano i tag HTML per motivi di sicurezza. Discord, Slack e alcuni editor CMS ignoreranno o rimuoveranno completamente i tag "". Se lavori in uno di questi ambienti, avrai bisogno di un approccio diverso.

Utilizzo dei CSS per sottolineare il testo in Markdown

Se hai accesso a stili personalizzati, i CSS ti offrono la massima flessibilità. Puoi utilizzare un tag <span> con uno stile in linea:

This is <span style="text-decoration: underline;">underlined text</span> in a sentence.

In alternativa, se controlli il foglio di stile per il tuo sito o la tua documentazione, puoi definire una classe personalizzata:

.underline {
  text-decoration: underline;
}

Quindi usalo nel tuo markdown:

This is <span class="underline">underlined text</span> in a sentence.

Questo metodo è ideale per blog, siti di documentazione e qualsiasi ambiente in cui gestisci il CSS. Mantiene il markdown più pulito rispetto agli stili in linea e offre una formattazione coerente nell'intero progetto.

Sottolineatura del ribasso in piattaforme specifiche

Diverse piattaforme gestiscono la formattazione della sottolineatura a modo loro. Ecco come affrontarlo negli ambienti più comuni.

GitHub

GitHub Flavored Markdown supporta l'HTML in linea, quindi il tag "" funziona nei file README, nei problemi, nelle descrizioni delle richieste pull e nei commenti. Ciò lo rende il metodo di sottolineatura del ribasso più semplice per gli utenti GitHub.

Taccuini Jupyter

Jupyter esegue il rendering delle celle di markdown con il supporto HTML completo. Sia il tag <u> che gli approcci basati su CSS funzionano in modo affidabile. Puoi anche utilizzare il tag <ins>, che rappresenta semanticamente il testo inserito ma viene visualizzato con una sottolineatura per impostazione predefinita:

This is <ins>underlined text</ins> in a notebook.

Discordia e allentamento

Né Discord né Slack supportano il markdown di sottolineatura in modo nativo. Discord utilizza la propria variazione di markdown, ma non include alcuna sintassi di sottolineatura. Slack utilizza interamente il proprio sistema di formattazione. In entrambi i casi, non esiste alcuna soluzione alternativa all'interno dell'input di messaggistica stesso.

Obsidian e app per prendere appunti

Alcune app per prendere appunti come Obsidian supportano snippet CSS personalizzati. Se la tua app lo consente, puoi definire una classe di sottolineatura nel tuo CSS e farvi riferimento nelle tue note. Controlla la documentazione della tua app specifica per i dettagli sull'abilitazione degli stili personalizzati.

Utilizzo del tag <ins> come alternativa

Il tag <ins> è un elemento HTML che rappresenta il testo inserito in un documento. I browser lo visualizzano con una sottolineatura per impostazione predefinita, rendendolo un'alternativa semantica al tag <u>:

The meeting is on <ins>Thursday</ins>, not Wednesday.

La differenza tra <u> e <ins> riguarda principalmente il significato. Utilizza <u> quando desideri semplicemente una sottolineatura visiva. Utilizza "" quando vuoi indicare che il testo è stato aggiunto o modificato, ad esempio in una cronologia di revisione o modifica.

Entrambi i tag producono lo stesso risultato visivo nella maggior parte dei parser markdown che supportano HTML.

Soluzioni alternative quando l'HTML non è supportato

Se stai lavorando su una piattaforma che elimina i tag HTML e non supporta la sottolineatura, le tue opzioni sono limitate. Ecco alcune soluzioni alternative comuni utilizzate dalle persone:

Sottolineatura falsa con caratteri Unicode. Puoi utilizzare Unicode combinando caratteri per simulare una sottolineatura, ma questo non è affidabile per tutti i tipi di carattere e piattaforme e generalmente non è consigliato.

Utilizza invece il grassetto o il corsivo. Se l'obiettivo è semplicemente attirare l'attenzione su un testo specifico, la formattazione in grassetto o corsivo può servire allo stesso scopo senza la necessità di sottolineare.

Aggiungi una nota tra parentesi. Negli ambienti di testo semplice, alcuni scrittori indicano l'enfasi aggiungendo una nota come "(enfasi mia)" dopo il testo pertinente.

Nessuno di questi è un vero sostituto del testo sottolineato del markdown, ma può essere utile in ambienti limitati.

Riferimento rapido

Ecco un riepilogo di tutti i metodi per sottolineare il testo nel markdown:

  • <u>testo</u> è il metodo più semplice e ampiamente supportato.
  • <ins>testo</ins> è un'alternativa semantica che viene resa anche come sottolineata.
  • CSS con tag <span> offre il massimo controllo quando gestisci il foglio di stile.
  • Non esiste alcuna sintassi nativa di sottolineatura del markdown, quindi tutti i metodi si basano su funzionalità HTML o specifiche della piattaforma.
  • GitHub e Jupyter supportano la sottolineatura basata su HTML.
  • Discord e Slack non supportano alcuna forma di formattazione della sottolineatura.

Considerazioni finali

La mancanza di una sintassi di sottolineatura del ribasso incorporata è una scelta progettuale deliberata, non una svista. Per la maggior parte dei contenuti Web, evitare le sottolineature mantiene il testo chiaro ed evita confusione con i collegamenti. Ma quando è necessario sottolineare il testo nel markdown, il tag "" è la soluzione più veloce e portabile. Scegli il metodo adatto alla tua piattaforma, tieni presente la leggibilità e i tuoi documenti appariranno esattamente come desideri.