Markdown spiegato in 5 minuti
Probabilmente hai già usato Markdown senza saperlo. Hai mai digitato **grassetto** in un messaggio su Slack? Hai scritto un README su GitHub? Hai formattato un post su Reddit? Quello è Markdown.
Markdown è un modo leggero per formattare il testo semplice usando simboli elementari. Invece di cliccare pulsanti sulla barra degli strumenti per grassetto, corsivo, intestazioni e liste, digiti pochi caratteri che indicano la formattazione desiderata. È stato creato nel 2004 da John Gruber e Aaron Swartz, e da allora è diventato il linguaggio di formattazione predefinito per sviluppatori, scrittori e chiunque lavori con il testo sul web.
Perché esiste Markdown
Prima di Markdown, formattare il testo per il web significava scrivere HTML. Per rendere una parola in grassetto, dovevi digitare <strong>grassetto</strong>. Per creare una lista, serviva <ul><li>elemento</li></ul>. L'HTML è potente ma verboso e difficile da leggere nella sua forma grezza.
Markdown risolve questo problema fornendo una stenografia leggibile dall'uomo. Il testo grezzo è facile da leggere anche prima di essere renderizzato. L'output formattato è pulito e professionale. Ottieni il meglio di entrambi i mondi: testo sorgente leggibile e output rifinito.
Lo sapevi? La filosofia di design di Markdown prevede che il testo grezzo debba essere "pubblicabile così com'è, come testo semplice, senza sembrare che sia stato marcato con tag o istruzioni di formattazione." Ecco perché la sintassi Markdown usa caratteri che suggeriscono visivamente la formattazione che producono.
La sintassi essenziale
Ecco tutto quello che devi sapere per iniziare a usare Markdown in modo produttivo.
Intestazioni
Usa i simboli cancelletto (#) per creare le intestazioni. Più cancelletti significano intestazioni più piccole.
# Intestazione 1 (la più grande)
## Intestazione 2
### Intestazione 3
#### Intestazione 4
Grassetto e corsivo
Racchiudi il testo tra asterischi o trattini bassi:
**testo in grassetto**
*testo in corsivo*
***grassetto e corsivo***
Liste
Le liste non ordinate usano trattini, asterischi o segni più. Le liste ordinate usano numeri.
- Primo elemento
- Secondo elemento
- Terzo elemento
1. Primo passo
2. Secondo passo
3. Terzo passo
Link
Parentesi quadre per il testo, parentesi tonde per l'URL:
[Clicca qui](https://example.com)
Immagini
Come i link, ma con un punto esclamativo davanti:
Citazioni
Usa il simbolo maggiore:
> Questa è una citazione. Sarà indentata e stilizzata diversamente.
Codice
Backtick per il codice inline, tripli backtick per i blocchi di codice:
Usa la funzione `print()` per visualizzare il testo.
Per blocchi di codice multiriga, usa tripli backtick con un identificatore di linguaggio opzionale:
```python
def hello():
print("Hello, world!")
```
Linee orizzontali
Tre o più trattini, asterischi o trattini bassi:
---
Tabelle
Usa pipe e trattini:
| Nome | Ruolo | Sede |
| --- | --- | --- |
| Alice | Sviluppatrice | Berlino |
| Bob | Designer | Londra |
Dove viene usato Markdown
Markdown è ovunque:
Sviluppo software
- GitHub, GitLab, Bitbucket: README, issue, pull request e documentazione sono tutti scritti in Markdown.
- Stack Overflow: Domande e risposte usano la formattazione Markdown.
- Documentazione del codice: Molti generatori di documentazione (Docusaurus, MkDocs, Jekyll) usano Markdown come formato sorgente.
Comunicazione
- Slack: Supporta un sottoinsieme di Markdown per la formattazione dei messaggi.
- Discord: Usa Markdown per grassetto, corsivo, blocchi di codice e altro.
- Reddit: Post e commenti sono formattati con Markdown.
Scrittura e pubblicazione
- Blog: Molti generatori di siti statici usano file Markdown come fonti di contenuto.
- Libri: Diversi strumenti di pubblicazione accettano manoscritti in Markdown.
- Note: App come Obsidian, Notion, Bear e Typora sono costruite intorno a Markdown.
Documentazione
- Documentazione tecnica: Documentazione API, guide utente e wiki usano comunemente Markdown.
- Basi di conoscenza interne: Molti team usano wiki basate su Markdown.
Suggerimento Puoi visualizzare in anteprima e praticare Markdown adesso, gratuitamente, nel tuo browser: Scrivi in Markdown. Visualizza l'output formattato in tempo reale mentre digiti.
Varianti di Markdown
Una cosa da sapere: esistono diverse "varianti" di Markdown. La sintassi di base è la stessa ovunque, ma alcune piattaforme aggiungono estensioni:
| Variante | Funzionalità extra | Usata da |
|---|---|---|
| CommonMark | Specifica rigorosa | Standard generale |
| GitHub Flavored Markdown (GFM) | Liste di attività, tabelle, testo barrato, auto-linking | GitHub |
| MultiMarkdown | Note a piè di pagina, citazioni, metadati | Scrittura accademica |
| R Markdown | Codice R incorporato, analisi dati | Data science |
Le differenze riguardano principalmente le funzionalità avanzate. Le basi (intestazioni, grassetto, corsivo, liste, link, immagini, codice) funzionano allo stesso modo ovunque.
Errori comuni
Dimenticare le righe vuote
Markdown richiede una riga vuota prima e dopo molti elementi. Un'intestazione ha bisogno di una riga vuota prima. Una lista ha bisogno di una riga vuota prima e dopo. Dimenticare queste righe vuote è la causa più comune di problemi di rendering.
Marcatori di lista incoerenti
Mischiare -, * e + nella stessa lista può causare rendering inaspettato. Scegline uno e attieniti a quello.
Spazi dopo i simboli
Alcuni processori Markdown richiedono uno spazio dopo il # nelle intestazioni e dopo il - nelle liste. Includi sempre lo spazio per sicurezza.
# Intestazione corretta
#Intestazione errata
- Elemento di lista corretto
-Elemento di lista errato
Attenzione Markdown non supporta tutte le esigenze di formattazione. Se hai bisogno di layout complessi, testo colorato, tipografia precisa o documenti pronti per la stampa, potresti aver bisogno di HTML, LaTeX o un elaboratore di testi. Markdown è ideale per contenuti strutturati e incentrati sul testo.
Perché vale la pena imparare Markdown
Markdown richiede cinque minuti per essere imparato e fa risparmiare ore nel tempo. Una volta che lo conosci, puoi:
- Scrivere documentazione che si visualizza magnificamente su GitHub
- Formattare messaggi in Slack e Discord senza toccare il mouse
- Prendere appunti strutturati che sono portabili tra le app
- Creare post per blog e contenuti web da file di testo semplice
- Collaborare su documenti testuali senza problemi di compatibilità dei formati
Il rapporto investimento-rendimento è uno dei migliori nell'intero mondo tech.
Inizia a scrivere in Markdown adesso:
Gratuito, nel tuo browser, con anteprima in tempo reale mentre digiti.