Guida alla Sintassi Markdown
Riferimento pratico alla sintassi Markdown con esempi
Prova Sintassi
Riferimento Sintassi
Cos'e' la Sintassi Markdown?
Markdown e' un linguaggio di formattazione di testo semplice e leggero creato da John Gruber nel 2004. Utilizza simboli e caratteri semplici per formattare il testo, rendendo facile scrivere contenuti che si convertono in HTML senza apparire disordinati nella forma grezza. Markdown e' diventato lo standard per documentazione, file README, blog e qualsiasi contenuto che necessita di formattazione semplice e leggibile.
CommonMark e' la specifica piu' ampiamente accettata per Markdown, che definisce come i parser devono interpretare la sintassi. Imparando la sintassi compatibile con CommonMark, il vostro contenuto sara' renderizzato in modo coerente su GitHub, GitLab, Discord, Slack, Reddit, Stack Overflow e decine di altre piattaforme. La specifica originale di Markdown di John Gruber rimane fondamentale, mentre estensioni come GitHub Flavored Markdown aggiungono funzionalita' come liste di attivita', testo barrato e tabelle.
Il Markdown moderno e' disponibile in diverse varianti su misura per piattaforme specifiche. GitHub Flavored Markdown (GFM) aggiunge tabelle, checkbox e autolink. GitLab Markdown supporta estensioni simili piu' diagrammi. Imparare la sintassi core di CommonMark offre una base portabile che funziona ovunque.
Come Usare la Guida alla Sintassi Markdown
Segui questi passaggi per imparare e provare la sintassi Markdown. Ogni passaggio utilizza i pannelli reali di questa pagina.
Incolla, Carica o Carica Esempio
Incolla Markdown nel pannello sinistro Prova Sintassi, oppure clicca su Carica per caricare un file .md. Clicca su Esempio per vedere documentazione API di esempio. Il pannello destro Riferimento Sintassi mostra i pattern CommonMark e GFM.
Praticare e Consultare
Usa il riferimento per titoli, enfasi, liste, link, tabelle, blocchi di codice. Copia gli esempi nel pannello sinistro per provarli. Copre CommonMark piu' le estensioni GitHub Flavored Markdown.
Copia o Scarica
Clicca su Copia o Scarica per salvare il riferimento. Usa Cancella per ricominciare. Tutta l'elaborazione avviene nel tuo browser.
Quando Lo Useresti Davvero
Scrivere Documentazione
Documentazione tecnica, guide di riferimento API e documentazione software sono scritte quasi universalmente in Markdown. Docs Python, guide Node.js e la maggior parte dei progetti open source usano Markdown per i loro siti di documentazione. Un riferimento alla sintassi ti mantiene produttivo nella scrittura di documentazione complessa.
README e File di Progetto
Ogni progetto GitHub ha un file README.md che descrive il progetto, l'utilizzo, l'installazione e le linee guida per i contributi. Questi file sono scritti interamente in Markdown e sono spesso la prima cosa che gli utenti vedono.
Creazione e Pubblicazione di Contenuti
Piattaforme blog come Jekyll, Hugo e Ghost accettano Markdown per i contenuti. Piattaforme stile Medium e generatori di siti statici usano Markdown come formato di input principale. Conoscere la sintassi aiuta a scrivere piu' velocemente e mantenere una formattazione coerente.
Comunicazione Collaborativa
Slack, Discord, issue di GitHub, commenti alle pull request e post nei forum supportano tutti la formattazione Markdown. Durante le code review, la segnalazione di bug o la collaborazione in chat, Markdown ti permette di formattare il tuo messaggio chiaramente senza interrompere il flusso della conversazione.
Domande Frequenti (FAQ)
Posso usare HTML all'interno del Markdown?
Si', Markdown permette di mischiare HTML grezzo. Se Markdown non supporta qualcosa di cui avete bisogno, potete scrivere HTML direttamente e passera' nell'output. Secondo la specifica CommonMark, i blocchi HTML e l'HTML inline sono riconosciuti e passati senza modifiche. Usatelo con parsimonia.
Qual e' la differenza tra asterischi e underscore per l'enfasi?
Funzionalmente sono identici in CommonMark — *testo* e _testo_ producono entrambi il corsivo, **testo** e __testo__ producono entrambi il grassetto. La scelta e' stilistica. Molti team preferiscono gli asterischi per coerenza e perche' sono piu' facili da digitare sulla maggior parte delle tastiere.
Come funzionano le interruzioni di riga in Markdown?
Questa e' una fonte comune di confusione. Un singolo ritorno a capo nella fonte viene trattato come uno spazio. Per creare una vera interruzione di riga (<br> in HTML), aggiungete due spazi alla fine della riga prima di premere Invio, oppure usate un backslash prima del ritorno a capo. Per le interruzioni di paragrafo, usate una riga vuota. La specifica CommonMark lo spiega in dettaglio.
Le tabelle sono supportate ovunque in Markdown?
No. Le tabelle fanno parte del GitHub Flavored Markdown e di altre estensioni, ma non sono nella specifica CommonMark. La maggior parte delle piattaforme moderne (GitHub, GitLab, Discord) le supporta, ma alcuni parser ignorano la sintassi pipe.
Come si eseguono l'escape dei caratteri speciali?
Usate un backslash (\) prima dei caratteri con significato speciale in Markdown: backslash (\), backtick (`), asterisco (*), underscore (_), parentesi graffe ({}), parentesi quadre ([]), parentesi tonde (()), cancelletto (#), piu' (+), meno (-), punto (.) e punto esclamativo (!). Per esempio, \*non corsivo\* renderizza gli asterischi letteralmente.
Qual e' il modo migliore per formattare il codice in Markdown?
Per il codice inline, usate backtick singoli: `codice qui`. Per i blocchi di codice, usate backtick tripli con un tag di linguaggio opzionale (```javascript) per l'evidenziazione della sintassi. Evitate di indentare il codice come blocco di codice — i blocchi recintati sono piu' chiari e piu' portabili.