---
title: "JSON, YAML e Markdown spiegati"
description: "JSON, YAML e Markdown sono tre formati in testo semplice che incontri di continuo. Impara a cosa serve ciascuno e come leggerli a colpo d'occhio."
type: "fundamental"
locale: "it"
category: "concepts"
canonical: "https://agenticschool.dev/it/fondamenti/json-yaml-markdown"
dateModified: "2026-06-12"
---

# JSON, YAML e Markdown spiegati

- Category: concepts
- Updated: 2026-06-12
- Keywords: JSON, YAML, Markdown, config files, data formats
- Canonical URL: https://agenticschool.dev/it/fondamenti/json-yaml-markdown
- Locale: it

> JSON, YAML e Markdown sono tre formati in testo semplice che incontri di continuo. Impara a cosa serve ciascuno e come leggerli a colpo d'occhio.

JSON, YAML e Markdown sono tre formati in testo semplice che incontri di continuo mentre costruisci. JSON e YAML memorizzano entrambi dati strutturati come impostazioni ed elenchi, mentre Markdown serve per testo formattato come documentazione e note. Nessuno è un linguaggio di programmazione; sono solo modi condivisi di scrivere informazioni perché sia gli umani sia i programmi possano leggerle. Una volta che riconosci i tre, la maggior parte dei file di configurazione smette di sembrare spaventosa.

## JSON: dati per le macchine

JSON (JavaScript Object Notation) memorizza i dati sotto forma di coppie chiave-valore, con parentesi graffe e virgolette. Lo trovi ovunque: risposte di API, file di pacchetti, impostazioni di applicazioni. È rigido, quindi una sola virgola o una virgoletta mancante lo rompe.

```json
{
  "name": "my-app",
  "version": "1.0.0",
  "private": true
}
```
Le chiavi e i valori di tipo stringa sono sempre tra virgolette doppie.

## YAML: dati per gli umani

YAML memorizza lo stesso tipo di dati di JSON, ma usa l'indentazione invece delle parentesi graffe, il che lo rende più facile da leggere e scrivere a mano. Lo trovi spesso nelle configurazioni di workflow e di deploy. La trappola: gli spazi contano. YAML usa spazi per l'indentazione, mai tabulazioni.

```yaml
name: my-app
version: 1.0.0
private: true
```
Gli stessi dati del JSON qui sopra, indentazione invece di parentesi graffe.

## Markdown: scrittura formattata

Markdown è per il testo, non per i dati. Aggiungi semplici simboli a del testo semplice per marcare titoli, grassetto, elenchi e link, e viene mostrato come contenuto graziosamente formattato. Questa pagina, la maggior parte dei README e i file di istruzioni IA come CLAUDE.md sono tutti in Markdown.

```markdown
# Un titolo

Un po' di testo **in grassetto** e un elenco:

- primo elemento
- secondo elemento
```
Un "#" fa un titolo; "**testo**" lo mette in grassetto; "-" fa un elenco.

## Come distinguerli

Una regola rapida dissipa quasi tutta la confusione. Se vedi parentesi graffe e molte virgolette, è JSON. Se vedi un'indentazione pulita con i due punti e senza parentesi graffe, è YAML. Se vedi titoli "#" ed elenchi puntati "-" pensati per un umano, è Markdown. Non devi scriverne nessuno perfettamente a mano, perché il tuo agente IA genera e modifica questi file per te. Aiuta riconoscere cosa è cosa, così quando uno strumento chiede "una configurazione YAML" o "un file JSON", sai cosa si aspetta e cogli un errore evidente a colpo d'occhio.

## FAQ

### Quando usare JSON invece di YAML?

Memorizzano lo stesso tipo di dati. JSON è più rigido e diffuso nel codice e nelle API; YAML è più piacevole da leggere e scrivere a mano e diffuso nelle configurazioni. Spesso è lo strumento a decidere quale ti serve.

### Markdown è un linguaggio di programmazione?

No. Markdown è un modo semplice di formattare testo con simboli in testo semplice. Si usa per documentazione, note e file di istruzioni IA, non per logica né dati.

### Perché il mio YAML si rompe di continuo?

Quasi sempre l'indentazione. YAML usa spazi, mai tabulazioni, e il numero di spazi conta. Allinea tutto in modo coerente, e la maggior parte degli errori YAML sparisce.