Vai al contenuto principale
HomeBlogSottolineare in Markdown: cosa funziona su GitHub e negli altri renderer

Sottolineare in Markdown: cosa funziona su GitHub e negli altri renderer

Markdown non ha sintassi nativa per la sottolineatura. Scopri quando funzionano <ins> e <u>, perché __text__ è grassetto e come scegliere un’alternativa portabile.

Published:

Markdown non ha una sintassi nativa per sottolineare il testo. In CommonMark e GitHub Flavored Markdown, _testo_ significa corsivo e __testo__ significa grassetto. La sottolineatura richiede di solito il supporto HTML o un’estensione specifica dell’applicazione.

Su GitHub, la forma documentata è:

La <ins>scadenza aggiornata</ins> è venerdì.

GitHub indica <ins>...</ins> per il testo sottolineato nella sua documentazione sulla formattazione di base. È un’opzione HTML supportata dalla piattaforma, non un nuovo delimitatore Markdown che funziona ovunque.

Confronto tra sottolineatura, grassetto e corsivo

Sorgente Significato Dove aspettarselo
_importante_ Enfasi, solitamente corsivo CommonMark e GFM
__importante__ Enfasi forte, solitamente grassetto CommonMark e GFM
**importante** Enfasi forte, solitamente grassetto CommonMark e GFM
<ins>testo aggiunto</ins> Testo inserito, solitamente sottolineato Renderer con HTML abilitato; documentato da GitHub
<u>testo annotato</u> Annotazione HTML, solitamente sottolineata Renderer che consentono questo elemento HTML

Scegli grassetto o corsivo quando vuoi dare enfasi. Per esempio, **Consegna venerdì** resta utile in un README, una nota e un’esportazione Markdown senza dipendere da HTML grezzo.

Qual è la differenza tra ins e u?

I due tag possono apparire simili, ma hanno significati diversi.

<ins> rappresenta testo inserito in un documento. È adatto a una revisione, come un requisito appena aggiunto. Il browser di solito lo sottolinea, ma un foglio di stile può cambiarne l’aspetto. Consulta la referenza MDN sul testo inserito.

La versione supporta <ins>importazioni CSV e TSV</ins>.

<u> contrassegna un’annotazione diversa dalla normale enfasi, come la segnalazione di un errore ortografico. L’HTML moderno non lo definisce come un generico tag per «rendere importante». Consulta la referenza MDN sull’elemento u.

Controlla l’ortografia di <u>accellerare</u>.

Se controlli un sito web e ti serve una sottolineatura puramente visiva, applica text-decoration: underline tramite CSS. Una piattaforma Markdown ospitata può rimuovere gli attributi di stile o impedire stili personalizzati, quindi neppure questo approccio è portabile.

Perché la sottolineatura funziona in un editor e scompare in un altro?

Ci sono tre decisioni separate: il parser Markdown riconosce HTML, l’applicazione sceglie quali tag consentire e il foglio di stile della destinazione determina l’aspetto degli elementi ammessi. Supportare GFM non garantisce che un prodotto consenta tutti i tag HTML.

L’editor MD File Viewer attualmente rimuove i tag HTML grezzi dall’input dell’utente. Incollando <ins>testo aggiunto</ins> o <u>testo annotato</u>, rimangono le parole senza quei tag, quindi l’anteprima non le sottolinea. Usa l’anteprima per la formattazione Markdown supportata e verifica la formattazione basata su HTML nella destinazione in cui verrà pubblicata.

Se stai trasferendo un documento HTML in Markdown, il convertitore da HTML a Markdown aiuta a recuperare testo, titoli, link ed elenchi. Sottolineatura e CSS personalizzato possono andare persi perché Markdown semplice non ha una sintassi equivalente. Controlla il risultato prima di sostituire il documento originale.

Esempi per README di GitHub

Per una breve aggiunta in una nota di modifica, l’opzione HTML documentata da GitHub è:

Questa versione aggiunge <ins>un passaggio di importazione facoltativo</ins>.

Per una scadenza o un requisito, usa l’enfasi Markdown:

**Obbligatorio:** Includere una riga di intestazione nel file CSV.

Per una destinazione, usa un link:

[Leggi le istruzioni di importazione](https://example.com/import)

Il testo sottolineato può sembrare un link cliccabile. Evita che etichette ordinarie sembrino interattive, soprattutto quando lo stesso paragrafo contiene link reali. La guida ai link Markdown tratta testi descrittivi dei link e link di riferimento.

Errori comuni con la sottolineatura

I doppi caratteri di sottolineatura rendono il testo grassetto. Passare da **parola** a __parola__ cambia il delimitatore, non il significato. Entrambi rappresentano enfasi forte.

I backtick mostrano il tag come codice. Scrivere `<ins>testo</ins>` è utile in un tutorial, ma mostra volutamente il markup invece di renderizzarlo.

Le scorciatoie da tastiera appartengono all’applicazione. Un editor di testo avanzato può offrire un comando di sottolineatura e salvare HTML o un proprio formato di documento. Questo non rende la sottolineatura parte del Markdown portabile.

Un titolo sottolineato è un concetto diverso. In questo sorgente, i trattini creano un titolo di secondo livello:

Note di rilascio
-------------

Non sottolineano una frase all’interno di un paragrafo. Per separare sezioni, usa una linea orizzontale Markdown con righe vuote intorno.

Domande frequenti

Come sottolineo in Markdown su GitHub?

Usa <ins>testo</ins>, che GitHub documenta per la sottolineatura. Per un’enfasi che funzioni anche nei renderer senza supporto HTML, usa invece **testo** o *testo*.

Esiste un’alternativa di sottolineatura solo in Markdown?

Non esiste un delimitatore standard per la sottolineatura. Alcune applicazioni aggiungono una propria sintassi, ma devi controllarne la documentazione e il formato usato nell’esportazione.

La sottolineatura sopravvive alla conversione da Markdown a PDF o Word?

Solo se il convertitore conserva l’HTML o l’estensione pertinente e ne supporta lo stile. Non presumere che una sottolineatura visibile nell’anteprima di un’applicazione sopravviva a un altro esportatore. Esamina il file risultante oppure usa il grassetto standard quando la portabilità è importante.

Il prontuario Markdown offre un riferimento compatto per le formattazioni dotate di una sintassi Markdown dedicata.

Try it in your browser

Open the homepage editor to view, edit, and export Markdown instantly — no install required.

More articles

Sottolineare in Markdown: cosa funziona su GitHub e negli altri renderer | MD File Viewer