Cosa butta via uno strumento che rimuove il Markdown, e come tenerlo

«Togliere il Markdown» suona come una singola operazione. In realtà è una serie di piccole decisioni, e un convertitore le prende tutte al posto tuo, che lo ammetta o no.

Ecco cosa di solito viene deciso male.

La numerazione degli elenchi

La più pesante. Le librerie più diffuse trattano un elenco come un costrutto di formattazione e lo appiattiscono, il che rimuove 1. 2. 3. insieme ai caratteri di punto elenco.

Per un elenco puntato si può discutere. Per uno numerato ne distrugge il significato: i numeri si riferivano a qualcosa. Risposte a un questionario numerato, passi di una sequenza, elementi in ordine di importanza: tutto diventa un mucchio disordinato.

Qui la numerazione si mantiene, compresi gli elenchi che partono da 7 e un elenco numerato annidato dentro un altro.

L’URL dietro un link

[la documentazione](https://example.com/guida) contiene due informazioni. Il testo semplice non ha dove mettere la seconda, quindi un convertitore deve o scriverla o lasciarla cadere.

Lasciarla cadere è silenzioso e comune. Chi legge riceve «la documentazione» e nessun modo di arrivarci. Qui l’impostazione predefinita le scrive entrambe — la documentazione (https://example.com/guida) — perché chi non può seguire il link ha perso qualcosa. Solo testo e solo URL restano disponibili quando sai che il link non conta.

Il linguaggio di un blocco di codice

Un blocco marcato ```java porta con sé un fatto: questo è Java. Togli la marcatura e quel fatto se ne va con lei, lasciando un blocco di simboli inspiegati che potrebbe essere qualsiasi cosa.

Il linguaggio viene emesso come etichetta — [java] — così chi legge lo capisce. Disattivato, o mantenuto come marcatura originale, se preferisci.

Il testo alternativo di un’immagine

Un’immagine non può sopravvivere come immagine. Ma il suo testo alternativo è una frase che qualcuno ha scritto per descriverla, ed è spesso l’unica descrizione di quel contenuto nel documento. Scartare l’immagine e tenere la descrizione di solito è meglio che scartarle entrambe.

Note a piè di pagina, citazioni, separatori, frontmatter

Ognuno è contenuto che uno strumento di rimozione può eliminare in silenzio. Qui ognuno è mantenuto per impostazione predefinita e disattivabile singolarmente.

Perché il senza perdite è l’impostazione giusta

La prova che risolve la maggior parte di questi casi: qualcuno che non ha mai visto l’ingresso riuscirebbe a capire tutto quello che diceva, dal solo risultato?

Se la risposta è no, il convertitore ha buttato informazione per conto di chi legge senza chiedere. Un convertitore che lascia qualcosa che devi cancellare tu è fastidioso per dieci secondi. Uno che cancella qualcosa che ti serviva è un problema che forse non noti finché non conta.

Perciò le impostazioni predefinite tengono tutto, e ogni rimozione è un interruttore che scegli. Una preimpostazione — Report e tabelle — infrange di proposito quella regola e toglie blocchi di codice e immagini, perché esiste per portare una tabella di confronto dentro un report dove uno spezzone vagante è rumore. È l’eccezione, lo dice, e la preimpostazione Predefinita non toglie assolutamente nulla.

Le cose che davvero non hanno una risposta

Alcune decisioni non hanno un’impostazione predefinita corretta, solo un contesto:

• Come appare un titolo quando niente può renderlo un titolo? Semplice, maiuscolo, o con # mantenuto.
• Come appare una tabella senza tabella? Colonne allineate, tabulazioni, o etichetta e valore.
• Come appare un elenco di attività? [ ], ☐, o niente.

È per questo che esistono le preimpostazioni. Invece di sceglierne una e chiamarla universale, ogni preimpostazione risponde a tutte queste domande per una destinazione precisa — un client di posta, un foglio di calcolo, una finestra di chat, una pagina di documentazione, un modulo web — e ti mostra un esempio, così vedi le risposte prima di fidartene.