Convertire e visualizzare l'anteprima del Markdown

Dashboard
Documentazione
API

converte il tuo Markdown in HTML e mostra un'anteprima in tempo reale, ideale per scrivere README, documentazione o articoli

Che cos'è Markdown?

Markdown è un linguaggio di markup leggero creato da John Gruber nel 2004. Permette di scrivere testo formattato utilizzando una sintassi semplice e leggibile allo stato grezzo, che viene poi convertita in HTML.

Questo strumento utilizza la specifica GFM (GitHub Flavored Markdown), la variante più diffusa, che aggiunge il supporto per tabelle, caselle di spunta, blocchi di codice con evidenziazione della sintassi e collegamenti automatici.

L'anteprima a destra si aggiorna in tempo reale durante la digitazione. Il pulsante Invia genera il codice HTML corrispondente, che puoi copiare o scaricare.

Sintassi Markdown di base

Markdown	Risultato
`# Titolo 1`	Titolo <h1>
`## Titolo 2`	Titolo <h2>
`grassetto`	grassetto
`corsivo`	corsivo
`codice inline`	`codice inline`
```php ... ```	Blocco di codice PHP
`[testo](url)`	Collegamento ipertestuale
`![alt](url)`	Immagine
`- item`	Elenco non ordinato
`1. item`	Elenco ordinato
`> citazione`	Blockquote
`---`	Separatore orizzontale

Casi d'uso comuni

README GitHub: scrivere la documentazione di un progetto open source.
Documentazione tecnica: redigere guide, wiki o pagine di documentazione (MkDocs, Docusaurus, Hugo).
Articoli di blog: la maggior parte dei CMS (Jekyll, Ghost, Contentful) accetta il Markdown.
Commenti e issue: GitHub, GitLab, Jira, Notion e Slack supportano tutti il GFM.
Email formattate: convertire il Markdown in HTML da integrare in un'email HTML.
Note e presentazioni: Obsidian, Notion, Marp e Reveal.js utilizzano il Markdown.

Domande frequenti

Qual è la differenza tra Markdown standard e GFM?

Il Markdown standard (CommonMark) copre gli elementi di base: titoli, elenchi, collegamenti, codice. GFM (GitHub Flavored Markdown) aggiunge le tabelle, le liste di attività (- [ ] item), il codice delimitato con linguaggio (```php), le menzioni e i collegamenti automatici. Questo strumento utilizza GFM tramite la libreria league/commonmark.

L'HTML generato è sicuro?

Sì. Il convertitore è configurato per rimuovere i tag HTML grezzi (html_input: strip) e bloccare i collegamenti non sicuri, il che impedisce gli attacchi XSS. L'HTML prodotto è adatto all'integrazione in una pagina web esistente.

Posso includere HTML nel mio Markdown?

Per motivi di sicurezza, l'HTML grezzo inserito nel Markdown viene rimosso durante la conversione. Se hai bisogno di un rendering HTML personalizzato, scrivi direttamente l'HTML di destinazione.

Qual è la dimensione massima del documento?

Non esiste un limite rigido lato server per questo strumento. Per documenti molto lunghi (oltre qualche migliaio di righe), l'anteprima in tempo reale può rallentare a seconda del tuo browser.

Esempio di richiesta

curl -X POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute \
  -H "Content-Type: application/json" \
  -d '{"input":"..."}'

Schema di input

Campo	Tipo	Richiesto	Predefinito
`input`	text		–

Endpoint

GET https://cdrn.fr/api/v1/tools - elenca tutti gli strumenti disponibili
GET https://cdrn.fr/api/v1/tools/markdown-formatter - recupera lo schema di questo strumento
POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute - esegue questo strumento con un payload JSON