Generatore di Immagini Markdown

Avanti

La sintassi immagine di Markdown, ![alt](src "title"), è facile da sbagliare: salti una parentesi, dimentichi il testo alternativo o la confondi con la sintassi dei link e il documento mostra un segnaposto rotto. Questo generatore prende l’URL dell’immagine, il testo alternativo, un titolo facoltativo e una destinazione di link facoltativa, e produce sia il Markdown in linea sia quello in stile riferimento, così incolli quello adatto al tuo documento.

Come generare la sintassi immagine di Markdown

  1. 1

    Incolla l'URL dell'immagine

    URL assoluto (https://...) o percorso relativo (/images/hero.png).

  2. 2

    Scrivi il testo alternativo

    Ciò che mostra l'immagine, in una frase. Indispensabile per l'accessibilità.

  3. 3

    Aggiungi un titolo (facoltativo)

    Mostrato al passaggio del mouse nella maggior parte dei renderer.

  4. 4

    Avvolgila in un link (facoltativo)

    Indica un URL per rendere l'immagine cliccabile.

  5. 5

    Copia lo snippet

    Ottieni l'output in linea `![alt](src)` o in stile riferimento `![alt][ref]`.

Le quattro varianti di sintassi

In linea, senza titolo:

![Immagine principale del prodotto](/images/hero.png)

In linea, con titolo:

![Immagine principale](/images/hero.png "Immagine principale scattata a ottobre 2026")

Immagine cliccabile (immagine avvolta in un link):

[![Immagine principale](/images/hero.png)](https://example.com/buy)

Stile riferimento (tiene gli URL lunghi fuori dal paragrafo):

![Immagine principale][hero]

[hero]: /images/hero.png "Immagine principale scattata a ottobre 2026"

Il testo alternativo conta

  • Accessibilità. Gli screen reader annunciano il testo alternativo; un alt vuoto rende l’immagine di fatto invisibile per un utente ipovedente.
  • SEO. I motori di ricerca usano il testo alternativo per capire il contenuto dell’immagine. Un alt mancante danneggia il traffico dalla ricerca immagini.
  • Degrado elegante. Se l’immagine non si carica, il testo alternativo è ciò che vedono gli utenti.

Testo alternativo buono e cattivo

Intento Buon testo alternativo Cattivo testo alternativo
Foto di prodotto “Tazza in ceramica rossa su una scrivania di legno, manico a sinistra” “Immagine di una tazza”
Screenshot “Pagina di accesso con e-mail, password e pulsanti SSO” “screenshot.png”
Decorativo "" (alt vuoto per pura decorazione) “immagine decorativa”
Infografica “Grafico a barre: i ricavi sono cresciuti da 1 Mln € nel 2023 a 3 Mln € nel 2026” “grafico a barre”

Trappole

  • Non iniziare l’alt con “Immagine di”, gli screen reader lo annunciano già come immagine.
  • Percorsi assoluti o relativi. I percorsi relativi si rompono quando il documento viene reso fuori dalla sua cartella (per esempio nell’anteprima di GitHub). Nel dubbio usa percorsi assoluti.
  • Gli spazi negli URL richiedono la codifica: %20 al posto di uno spazio, altrimenti l’immagine non si carica.

Domande frequenti

Non in Markdown puro. La maggior parte dei renderer (GFM, Docusaurus, MkDocs) ricorre all’HTML grezzo per il dimensionamento, <img src="..." width="400" alt="...">. Alcuni dialetti supportano ![alt](url =400x), ma non è universale.

L’alt è il testo annunciato agli screen reader e mostrato se l’immagine non si carica. Il titolo è il tooltip che compare al passaggio del mouse: di norma facoltativo e ignorato sui dispositivi touch.

Quando l’immagine compare più volte, o quando l’URL è lungo e ingombra il paragrafo. Lo stile riferimento mantiene il testo leggibile e riduce le modifiche dell’URL a una sola.

Sì, annidare un’immagine in un link ([![alt](img)](url)) è CommonMark standard. L’output reso è un collegamento ipertestuale che avvolge un <img>.

Strumenti correlati

Strumento disponibile in altre lingue