In breve
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.
{
"name": "my-app",
"version": "1.0.0",
"private": true
}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.
name: my-app
version: 1.0.0
private: trueMarkdown: 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.
# Un titolo
Un po' di testo **in grassetto** e un elenco:
- primo elemento
- secondo elementoCome 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.