Per chi
Tabelle che arrivano intere
I convertitori generici da HTML a Markdown si rompono proprio sulle tabelle che contano, quelle con un elenco, un link o un pezzo di codice dentro una cella. L’estensione scrive la tabella da sé e appiattisce il contenuto della cella invece di perdere la riga. Su un corpus di quindici tabelle ne sono passate dodici intere, contro sette per ciascun motore confrontato.
La tabella persa per strada
Il dato che ti interessa in una pagina sta quasi sempre dentro una tabella, ed è proprio la cosa che arriva peggio. Basta una cella con un elenco puntato, un link o un pezzetto di codice per far deragliare un convertitore generico: la riga si ripiega, le colonne slittano di uno, e i numeri si ritrovano davanti alle etichette sbagliate. Il guaio è che alla rilettura non sempre si vede.
Accanto a questo, le pagine sono piene di tabelle che tabelle non sono. Ci sono griglie usate solo per mettere dei blocchi uno accanto all’altro, e uno strumento che le riproduce fedelmente riempie i tuoi appunti di griglie vuote. Così passi tanto tempo a cancellare tabelle finte quanto a riparare quelle vere.
Il danno peggiore però è quello che non si vede: la riga di testo sotto la tabella. È lì che sta scritto che i valori sono in migliaia, che il dato del 2020 è provvisorio, che la serie è stata ricostruita dopo un cambio di classificazione. Una tabella presa senza il suo contorno di testo è una griglia di numeri senza unità, e quei numeri finiscono in una slide con un ordine di grandezza sbagliato senza che nessuno in sala possa accorgersene.
Che cosa diventa una tabella
- Serializzatore di tabelle GFM proprio dell’estensione, non un plugin generico
- Dodici tabelle su quindici tenute sul corpus tecnico, contro sette per ciascun motore confrontato
- Una cella con un elenco, un link o del codice viene appiattita con ordine invece di spezzare la riga
- Le tabelle a due colonne irregolari diventano righe
Chiave: valoreinvece di una griglia rotta - Le tabelle di impaginazione – le griglie che servono solo a posizionare – vengono aperte, non riprodotte
- Seleziona la sola tabella ed è la sola tabella a essere salvata, con il suo frontmatter
- Le note e le didascalie sotto la tabella fanno parte del corpo dell’articolo e arrivano con lei: l’unità di misura non resta sulla pagina
- Il campo
sourcein cima al file dice da quale pagina viene la serie, quindi un numero finito in una presentazione resta rintracciabile
--- title: "Popolazione residente al 1° gennaio" source: "https://www.istat.it/statistiche/popolazione-residente" extraction: "dom" --- | Anno | Popolazione residente | Quota 65 anni e oltre | | --- | --- | --- | | 2022 | 59.030.133 | 23,5 % | | 2023 | 58.850.717 | 24,0 % | | 2024 | 58.989.749 | 24,3 % |
Impostarlo per prendere i dati
Una tabella presa bene è una tabella che arriva con il suo contorno di testo e con l’indirizzo da cui viene. Queste sei mosse servono a quello, e si fanno una volta sola.
- Apri le opzioni con il clic destro sull’icona e imposta come destinazione la cartella in cui tieni i dati del progetto, accanto ai notebook e ai fogli di lavoro che li useranno.
- Lascia il clic sull’icona sulla finestra di anteprima. Sulle tabelle è il controllo che serve davvero: la vista lettura disegna la tabella come sarà nel file, quindi vedi subito se una colonna è slittata.
- Metti il modello del nome file su
{date}-{domain}-{title}. La data è quella dell’estrazione, e su una serie che l’istituto rivede periodicamente sapere quando l’hai presa vale quanto il dato stesso. - Accendi
title,sourceepublished.sourceè il campo che ti permette di risalire dalla slide alla pagina, ed è quello che ti chiederanno quando il numero verrà messo in dubbio. - Prima di salvare, scorri la pagina fino in fondo alla tabella e apri le note che stanno sotto. Sono quelle che dichiarano l’unità di misura e i dati provvisori, e vengono prese solo se sono nella pagina disegnata.
- Se la tabella ha la paginazione, imposta la vista a «tutte le righe» sulla pagina stessa prima di salvare. L’estensione non fa scattare i controlli della tabella: prende quello che è a schermo.
Impostazioni per chi analizza
Il criterio qui è la tracciabilità: ogni tabella deve poter tornare alla pagina da cui è stata presa, e ogni numero deve portarsi dietro l’unità in cui è espresso.
| Impostazione | Valore | Perché proprio questo |
|---|---|---|
| Clic sull’icona | Apri la finestra di anteprima | La vista lettura disegna la tabella come sarà: una colonna slittata si vede subito |
| Modello del nome file | `{date}-{domain}-{title}` | Su una serie rivista periodicamente, sapere quando l’hai presa vale quanto il dato |
| Frontmatter | `title`, `source` e `published` | `source` è la strada di ritorno dalla slide alla pagina, quando il numero viene messo in dubbio |
| Cartella | Accanto ai notebook del progetto | La tabella e il codice che la usa si versionano e si cercano insieme |
| Immagini | Salta | Un grafico è un’immagine: nel file resterebbe un link, e i numeri non sono lì dentro comunque |
| Regola per sito | Portali statistici → sottocartella `serie` | Le tabelle ufficiali si rileggono spesso e conviene tenerle separate dagli articoli che le commentano |
| Regione | Occupati 2023 | Occupati 2024 | Tasso 2023 | Tasso 2024 | | --- | --- | --- | --- | --- | | Lombardia | 4.412.000 | 4.451.000 | 68,9 % | 69,4 % | | Lazio | 2.383.000 | 2.401.000 | 62,7 % | 63,1 % | Nella pagina la testata era su due piani: una cella «Occupati» che copriva due colonne e una cella «Tasso di occupazione» che ne copriva altre due. Markdown non ha celle unite, quindi il raggruppamento è stato aperto e riportato in ogni intestazione. Il contenuto resta, la fusione visiva no.
Tre passaggi di lavoro
Una serie ufficiale dentro un notebook
La tabella della popolazione residente sta su una pagina del portale statistico, con la sua nota sotto che dice quali anni sono provvisori. La selezioni insieme alla nota e salvi la selezione: nel file arrivano la tabella GFM e la riga di testo che la qualifica, con l’indirizzo e la data in cima.
Il Markdown si incolla direttamente nella cella di testo del notebook, e i valori si copiano nel foglio senza passare da un ritaglio a mano. Sei mesi dopo l’istituto rivede la serie: il tuo file dice quale versione avevi usato, perché la data del salvataggio è nel nome.
Una tabella di confronto che i convertitori generici rompono
La pagina di documentazione di un prodotto ha una tabella in cui tre celle contengono un elenco puntato e due contengono un frammento di codice. È il caso esatto in cui un convertitore generico ripiega la riga e sposta le colonne di uno.
Qui la cella viene appiattita con ordine e la riga resta al suo posto. Sul corpus di quindici tabelle ne sono passate dodici intere, contro sette per ciascuno dei motori confrontati – e la differenza sta quasi tutta in queste celle, quelle con dentro qualcosa che non è solo testo.
La griglia che tabella non era
Salvi una pagina che sembra piena di tabelle e nel file non ce n’è quasi nessuna: erano griglie di impaginazione, usate per mettere tre riquadri uno accanto all’altro. Il contenuto dei riquadri c’è, uno sotto l’altro; la griglia no.
È il comportamento voluto, e all’inizio spiazza. Riprodurre una griglia di posizionamento come tabella Markdown riempie gli appunti di celle vuote da cancellare a mano – un lavoro che assomiglia molto a quello di riparare le tabelle vere, e che nessuno ha messo in preventivo.
Rispetto agli altri modi di prendere una tabella
I modi per portare una tabella dalla pagina al proprio strumento sono cinque, e ognuno ha un punto in cui si rompe. La terza colonna dice qual è, anche per noi.
| Come si fa adesso | Che cosa ottieni | Che cosa costa |
|---|---|---|
| Selezione e incolla nel foglio di calcolo | Le colonne, quando va bene | Una cella con un elenco o un link fa slittare tutta la riga, e non sempre si vede |
| Esportazione CSV del sito | Dati puliti, quando esiste | La maggior parte delle pagine non la offre, e a volte l’export differisce da ciò che è mostrato |
| Schermata della tabella | L’aspetto esatto, celle unite comprese | I numeri non si copiano, non si sommano e non si cercano |
| Ritrascrizione a mano | Controllo totale su ogni cella | È il metodo che introduce gli errori peggiori, perché sembrano dati e non refusi |
| Clean Clipper | Una tabella GFM con la sua nota e l’indirizzo sopra | Niente CSV, celle unite appiattite, e nessun numero letto da un grafico |
Quando la tabella esce storta
Perché mancano delle righe?
Perché non erano a schermo. Una tabella con la paginazione consegna la pagina corrente, e una che carica le righe mentre scorri consegna quelle già caricate: l’estensione converte quello che il browser ha disegnato e non tocca i controlli della tabella. Imposta «tutte le righe» o scorri fino in fondo prima di salvare, e ricontrolla il conteggio nella vista lettura.
Perché l’intestazione è diversa da quella sulla pagina?
Perché la testata era su più piani, con celle unite che coprivano due o tre colonne. Markdown non ha celle unite, quindi il raggruppamento viene aperto e riportato in ogni intestazione: «Occupati 2023», «Occupati 2024» al posto di una cella «Occupati» che ne copriva due. Il contenuto resta, la fusione visiva no – ed è un limite del formato, non della conversione.
Perché una tabella è diventata un elenco di righe Chiave: valore?
Perché era una tabella a due colonne irregolare, del tipo che i siti usano per le schede tecniche. Riprodurla come griglia darebbe una tabella con una colonna vuota su tre righe e il testo che sborda; la forma chiave-valore conserva le stesse coppie ed è leggibile sia nel file sia in una nota.
Perché i numeri del grafico non ci sono?
Perché un grafico è un’immagine o un disegno fatto via codice, e in nessuno dei due casi i numeri sono testo nella pagina. L’estensione non legge valori da un’immagine e non interroga la libreria che disegna il grafico. Dove il sito pubblica anche la tabella sottostante, è quella che va salvata; dove offre un export, conviene usare quello.
Che cosa non fa
Non esporta in CSV, in Excel o in JSON: il risultato è una tabella Markdown, da convertire dopo se il tuo strumento lo pretende. Le celle unite vengono appiattite, perché Markdown non sa esprimerle. Non legge una tabella resa come immagine o disegnata in canvas, e non fa scattare la paginazione di una tabella interattiva: quello che non è a schermo non viene salvato. Le griglie di impaginazione molto annidate restano difficili per qualsiasi strumento.