Hosting immagini Markdown: immagini per README GitHub, documentazione e note

Di Product Team

Carica uno screenshot, uno schema o una GIF. Ottieni il codice Markdown pronto da incollare in un README, in una wiki o nelle tue note: gratis, senza registrazione e il link non scade.

Carica un'immagine

★ Valutazione 4.7/5 su 326 valutazioni degli utenti

Il Markdown mostra un'immagine a partire da un link: ![alt text](image link). L'immagine deve essere online da qualche parte. YourImageShare la ospita gratis e ti dà la riga Markdown pronta da incollare, per GitHub, GitLab, Obsidian, siti di documentazione o qualsiasi altro file Markdown.

Ottenere il Markdown di un'immagine

  1. Carica l'immagine. Premi Carica un'immagine, oppure da computer incolla uno screenshot direttamente dagli appunti con Ctrl+V.
  2. Apri la scheda Markdown quando il caricamento è finito e copia il codice.
  3. Incollalo nel tuo file.

La scheda Markdown ti dà un'immagine cliccabile che apre la versione a dimensione intera:

[![AbC123xYz0](https://yourimageshare.com/ib/AbC123xYz0.png)](https://yourimageshare.com/ib/AbC123xYz0)

Per un'immagine semplice senza link, tieni solo la parte interna e scrivi un vero testo alternativo:

![Settings screen](https://yourimageshare.com/ib/AbC123xYz0.png)

Immagini nei README, nelle issue e nelle wiki di GitHub

GitHub mostra le immagini esterne in README, issue, pull request, discussioni e wiki. Incolla il codice Markdown e l'immagine appare quando la pagina viene visualizzata.

  • Imposta una dimensione con un tag HTML, che GitHub consente nel Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • Le GIF dimostrative continuano a riprodursi in un README: vedi hosting GIF, oppure trasforma una registrazione dello schermo in GIF con il convertitore da video a GIF.
  • Il testo alternativo descrive l'immagine per gli screen reader e compare se l'immagine non si carica.

Obsidian, Notion e siti di documentazione

  • Obsidian, Typora, anteprima di VS Code e altri editor Markdown mostrano l'immagine a partire dal link, così le tue note restano leggere e l'immagine funziona su ogni dispositivo.
  • Notion: scrivi /image, scegli Embed link e incolla il link diretto (scheda Direct).
  • I siti di documentazione creati con MkDocs, Docusaurus, Jekyll, Hugo o GitBook interpretano la stessa sintassi Markdown per le immagini.

Perché ospitare le immagini fuori dal repository

  • Repository più leggeri. Screenshot e GIF aggiungono megabyte a ogni clone, per sempre, anche dopo che li hai sostituiti. Un'immagine ospitata viene caricata solo quando qualcuno guarda la pagina.
  • I link non scadono. Le immagini restano online finché non le elimini.
  • Senza registrazione e senza niente da configurare. Per script e CI c'è una API di caricamento gratuita.
  • Piena risoluzione e nessuna filigrana. I dati EXIF, posizione compresa, vengono rimossi prima di salvare l'immagine.

Domande frequenti

Come aggiungo un'immagine a un file Markdown?
Carica l'immagine, copia il codice dalla scheda Markdown e incollalo nel file. In Markdown un'immagine si mostra con ![alt text](image link).
Posso usare queste immagini in un README di GitHub?
Sì. GitHub mostra le immagini esterne in README, issue, pull request e wiki. Incolla il codice Markdown e l'immagine appare quando il file viene visualizzato.
Come imposto la dimensione di un'immagine in un README?
Il Markdown semplice non ha opzioni per la dimensione. Su GitHub usa un tag HTML per l'immagine con una larghezza, per esempio <img src="image link" width="400" alt="Screenshot">.
Perché ospitare le immagini del README fuori dal repository?
Screenshot e GIF dimostrative aggiungono megabyte a ogni clone del repository. Un'immagine ospitata viene caricata solo quando qualcuno guarda il README.
I link delle immagini scadono?
No. Le immagini restano online finché non le elimini, quindi i link nella documentazione continuano a funzionare.

Pronto a caricare la tua immagine?