Markdown è una sintassi di formattazione di testo leggera che trasforma il testo semplice in documenti strutturati. Creato nel 2004 da John Gruber, è ora il formato standard per la documentazione, i file README, i post sui blog e la comunicazione degli sviluppatori. Questa guida spiega cos'è Markdown, perché la gente la usa e come iniziare.
Che cos'è il Markdown?
Markdown è un modo per aggiungere formattazione al testo semplice utilizzando semplici caratteri di punteggiatura. Scrivi in un editor di testo, e il Markdown viene reso in output formattato (HTML, PDF, ecc.) da un processore.
Per esempio:
# This is a Heading
This is a **bold word** and this is *italic*.
- List item one
- List item twoRender come:
Questa è una rubrica
Questo è un parola in grassetto E questo è italic.
- Articolo 1 dell'elenco
- Articolo 2 dell'elenco
La formattazione vive nel testo stesso nessun XML nascosto, nessun formato binario, nessuna codifica proprietaria.
Perché è stato creato il Markdown?
Prima di Markdown, gli scrittori web si trovavano di fronte a una scelta: scrivere in HTML grezzo (noioso e soggetto ad errori) o utilizzare un editor WYSIWYG che produceva codice disordinato. John Gruber ha progettato Markdown per essere:
- Leggibile così com'è Anche senza rendering,
**bold**Legge chiaramente come enfasi - Scritta da chiunque Nessun software speciale, solo un editor di testo
- Convertibile in HTML Il formato di uscita primario
La specifica originale si concentrava sulla produzione di HTML puliti. Ma Markdown da allora si è diffuso in dozzine di piattaforme e formati di output.
Dove si usa Markdown?
Markdown è ovunque nella tecnologia:
| Piattaforma | Che cosa fa Markdown |
|---|---|
| GitHub | README, problemi, richieste di pull, wiki |
| Notion | Contenuto delle pagine e dei documenti |
| Obsidian | Tutte le note sono nella cassaforte . |
| Wordpress | Pubblicazioni tramite il plugin Markdown |
| GitBook | Pagine di documentazione |
| Slack / Discord | Formattazione dei messaggi |
| Superfluo di pila | Domande e risposte |
| Jekyll / Hugo / Astro | Pubblicazioni su blog e pagine statiche |
| Notebook di Giove | Cellule di documentazione |
Se scrivete contenuti tecnici, avete quasi certamente incontrato Markdown.
Markdown contro Word: Principali differenze
| Aspetto | Word | Markdown |
|---|---|---|
| Formatto | Numero binario (.docx) | Testo semplice (.md) |
| Trasportabilità | Richiede Word o app compatibile | Si apre in qualsiasi editor di testo |
| Controllo delle versioni | Difficile (differenze binarie) | Facile (differenze Git linea per linea) |
| Rendering | Integrato nell'app | Richiede un renderer Markdown |
| Curva di apprendimento | WYSIWYG (nessun apprendimento) | Richiede l'apprendimento della sintassi |
| Supporto delle piattaforme | Ecosistema Microsoft | Strumenti universali per gli sviluppatori |
Se hai Word documenti che vuoi convertire in Markdown, WordToMD Non ci si iscrive, non si carica.
Sintassi Markdown di base
Ecco gli elementi più comuni:
Rubriche
# Heading 1
## Heading 2
### Heading 3Vede la tabella Markdown Guida delle rubriche per il riferimento completo.
L'accento
**Bold text**
*Italic text*
~~Strikethrough~~Lista dei paesi
- Unordered item
- Another item
- Nested item
1. First
2. Second
3. ThirdConnessioni
[Link text](https://example.com)Immagini
Codice
Inline: `code snippet`
Block:
```python
print("Hello, Markdown!")
See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).
### Tables
```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |Vede la tabella Markdown Tabelle: una guida completa.
Quota di blocco
> This is a blockquote.
> It can span multiple lines.Markdown Sapori
Markdown non è un unico standard ci sono diverse varianti:
- CommonMark Una specifica rigorosa e inequivocabile
- GitHub Aromatizzati Markdown (GFM) CommonMark + tabelle, elenchi di attività, passaggi, collegamenti automatici
- MultiMarkdown Aggiunge note a piè di pagina, citazioni, metadati
- - Non lo so. - Non lo so. Più ricco di funzionalità, utilizzato dal convertitore Pandoc
La maggior parte delle piattaforme supporta almeno CommonMark. GitHub, Obsidian, e GitBook usano GFM. Per un riferimento completo, si veda Markdown Sintassi guida rapida.
Come scrivere Markdown
Non hai bisogno di un software speciale. Le opzioni includono:
- Codice VS Editor gratuito e potente con anteprima Markdown integrata
- Obsidian Markdown App per prendere appunti con visualizzazione grafica
- Tipora Editor WYSIWYG Markdown
- iA Scrittore Ambiente di scrittura concentrato
- Qualsiasi editor di testo semplice Notepad, TextEdit, vim, emacs
Conversione tra Markdown e altri formati
Se hai Word documenti da convertire in Markdown, WordToMD lo fa in pochi secondi, completamente gratuito, senza caricare file.
Per il contrario (Markdown a Word o PDF), strumenti come Pandoc gestiscono questa conversione. Vede la tabella Pandoc Word a Markdown per le istruzioni di installazione.
FAQ
Markdown è un linguaggio di programmazione? - No, no, no, no, no. Markdown è un linguaggio di marcatura descrive la formattazione, non la logica o il calcolo.
Posso usare Markdown in Microsoft Word? Word non rende nativamente Markdown, ma ci sono add-in Word che aggiungono supporto Markdown. In alternativa, convertire Word in Markdown con WordToMD e utilizzare un Markdown editor.
È Markdown buono per documenti lunghi? Sì, con una buona struttura di direzione. Documenti molto lunghi beneficiano della divisione in più file (come nei caveau GitBook o Obsidian).
Quale estensione file usa Markdown?
.md e' lo standard. .markdown è anche valido. Alcune piattaforme utilizzano .mdx per Markdown con componenti JSX (React).
Conclusioni
Markdown è un formato semplice e potente che è diventato la lingua franca della scrittura tecnica. È leggibile come testo semplice, rende bellissimo e funziona con tutti i principali strumenti di sviluppo. Se siete nuovi, iniziate con il Markdown Sintassi guida rapida e prova a convertire il tuo primo documento Word a WordToMD.