Vai al contenuto
MarkdownToHTML

Guida

Markdown to HTML per email

Scrivi in Markdown, invia HTML vero. Ecco perché l’email richiede un output diverso rispetto a una pagina web, e come ottenerlo.

Perché l’HTML normale si rompe nelle email

I client email non sono browser. Molti rimuovono o ignorano i blocchi <style>, i fogli di stile esterni e la maggior parte del CSS moderno. HTML che sembra perfetto su una pagina web può arrivare in una casella di posta con font predefiniti, nessuna spaziatura e tabelle rotte.

L’approccio affidabile è applicare gli stili direttamente su ogni elemento con l’attributo style. È esattamente ciò che fa la modalità di output A prova di email.

Cosa cambia il convertitore

Scegliendo A prova di email (stili inline) nelle Opzioni, il tuo Markdown viene convertito come al solito, poi vengono aggiunti stili inline a ogni elemento:

<p style="margin:0 0 16px;font-size:16px;line-height:26px;color:#333333;">
  Hello from Markdown.
</p>
  • Titoli, paragrafi, link, liste, citazioni, codice, tabelle e linee ottengono dimensioni, margini e colori espliciti.
  • Le classi di evidenziazione della sintassi vengono disattivate, perché i client email eliminano lo stile basato su classi.
  • L’output è un frammento. Incollalo nel corpo del tuo editor di email o newsletter.

Come usarlo

  1. Apri il convertitore con l’output A prova di email selezionato.
  2. Incolla o digita il tuo Markdown.
  3. Controlla l’anteprima, poi scegli Copia HTML.
  4. Incollalo nell’editor HTML o sorgente del tuo strumento di posta.

Prima di inviare

  • Usa URL assoluti per le immagini (https://…) e scrivi sempre il testo alternativo. I percorsi relativi non si risolvono in una casella di posta.
  • Invia un test a te stesso. Gmail, Outlook e Apple Mail renderizzano in modo leggermente diverso, specialmente Outlook su Windows.
  • Mantieni la semplicità. I contenuti a colonna singola si convertono in modo affidabile. Layout complessi a più colonne richiedono un template email dedicato.
  • Tieni conto della modalità scura. Alcuni client invertono automaticamente i colori, quindi verifica il contrasto in entrambe le modalità.
  • Lascia attiva la sanificazione a meno che tu non ti fidi completamente della fonte del tuo Markdown.

Cosa non fa

Il convertitore applica stili al contenuto, non ai layout: non c’è alcun sistema di header, footer, pulsanti o colonne. Usalo per il corpo testuale di un messaggio e combinalo con il template della tua piattaforma email per il resto.