Barrato

Il barrato è una sintassi estesa in Markdown utilizzata per indicare testo eliminato o non più valido. È molto utile nelle revisioni dei documenti, elenchi di attività, variazioni di prezzo e altri scenari.

Sintassi Base

Sintassi Standard

In Markdown, il barrato utilizza tipicamente due tilde (~~) per racchiudere il testo da barrare:

Questo è un esempio che contiene ~~testo barrato~~.

Effetto di Rendering:

Questo è un esempio che contiene testo barrato.

Parole e Frasi

Il barrato può essere applicato a singole parole o intere frasi:

~~Questa intera frase è barrata.~~

La riunione si terrà la prossima settimana ~~lunedì~~ martedì.

Effetto di Rendering:

Questa intera frase è barrata.

La riunione si terrà la prossima settimana lunedì martedì.

Uso Avanzato

Combinare con Altri Formati

Il barrato può essere combinato con altri formati Markdown:

~~**Barrato in grassetto**~~

~~*Barrato in corsivo*~~

~~***Barrato grassetto corsivo***~~

~~`Barrato codice`~~

~~[Barrato link](https://www.markdownlang.com)~~

Effetto di Rendering:

Barrato in grassetto

Barrato in corsivo

Barrato grassetto corsivo

Barrato codice

Barrato link

Paragrafi e Blocchi

In alcune implementazioni Markdown, il barrato può essere applicato a interi paragrafi o blocchi:

~~
Questo è un paragrafo eliminato completo.
Può contenere più righe di contenuto.
~~

Nota: Non tutti i processori Markdown supportano il barrato su più righe. Per contenuti multilinea, il modo più sicuro è applicare il barrato a ogni riga singolarmente.

Compatibilità e Differenze di Implementazione

Stato di Supporto sulle Diverse Piattaforme

Piattaforma/Strumento	Supporto Barrato	Sintassi
GitHub Markdown	✅	~~barrato~~
GitLab Markdown	✅	~~barrato~~
Stack Overflow	✅	~~barrato~~
Discord	✅	~~barrato~~
Reddit	✅	~~barrato~~
CommonMark	✅	~~barrato~~
VitePress	✅	~~barrato~~
Pandoc	✅	~~barrato~~

Formato Output HTML

La maggior parte dei processori Markdown converte il barrato in tag HTML <del> o <s>:

<!-- Usando il tag <del> -->
<p>Questo è un esempio che contiene <del>testo barrato</del>.</p>

<!-- O usando il tag <s> -->
<p>Questo è un esempio che contiene <s>testo barrato</s>.</p>

Sintassi Alternativa

Alcune piattaforme o versioni vecchie di Markdown possono supportare sintassi diverse:

<!-- Tilde singola (alcune piattaforme) -->
~testo barrato~

<!-- Tag HTML (tutti i processori Markdown conformi) -->
<del>testo barrato</del>
<s>testo barrato</s>

Casi d'Uso

Revisioni di Documenti

Il barrato è comunemente usato per mostrare revisioni e modifiche:

# Piano Progetto v2.0

## Cronoprogramma

- Analisi requisiti: ~~1-15 marzo~~ 1-20 marzo (ritardato)
- Fase di design: ~~16 marzo-5 aprile~~ 21 marzo-10 aprile
- Sviluppo: 11 aprile-15 maggio
- Test: 16-30 maggio
- Rilascio: ~~1 giugno~~ 15 giugno

Effetto di Rendering:

Piano Progetto v2.0

Cronoprogramma

• Analisi requisiti: 1-15 marzo 1-20 marzo (ritardato)
• Fase di design: 16 marzo-5 aprile 21 marzo-10 aprile
• Sviluppo: 11 aprile-15 maggio
• Test: 16-30 maggio
• Rilascio: 1 giugno 15 giugno

Elenchi di Attività

Il barrato combinato con le checkbox crea elenchi di attività più intuitivi:

## Attività della Settimana

- [x] ~~Completare la proposta di progetto~~
- [x] ~~Incontrare il cliente per discutere i requisiti~~
- [ ] Creare il prototipo di design
- [ ] Scrivere il documento tecnico
- [ ] Preparare la stima dei costi

Effetto di Rendering:

Attività della Settimana

• [x] Completare la proposta di progetto
• [x] Incontrare il cliente per discutere i requisiti
• [ ] Creare il prototipo di design
• [ ] Scrivere il documento tecnico
• [ ] Preparare la stima dei costi

Prezzi e Promozioni

Il barrato è molto utile in contenuti e-commerce e promozionali:

## Offerte Speciali

- Laptop ad alte prestazioni: ~~€8.999~~ €7.499
- Cuffie wireless: ~~€1.299~~ €999
- Smartwatch: ~~€2.499~~ €1.999

*Promozione valida fino al 31 dicembre 2023*

Effetto di Rendering:

Offerte Speciali

• Laptop ad alte prestazioni: €8.999 €7.499
• Cuffie wireless: €1.299 €999
• Smartwatch: €2.499 €1.999

Promozione valida fino al 31 dicembre 2023

Umorismo ed Enfasi

Il barrato viene talvolta usato per esprimere umorismo o enfasi:

La riunione di oggi è stata ~~molto noiosa~~ molto produttiva.

Io ~~odio~~ adoro scrivere documentazione.

Questo progetto ~~potrebbe fallire~~ avrà sicuramente successo!

Effetto di Rendering:

La riunione di oggi è stata molto noiosa molto produttiva.

Io odio adoro scrivere documentazione.

Questo progetto potrebbe fallire avrà sicuramente successo!

Best Practice

Raccomandazioni d'Uso

✅ Pratiche consigliate:

1. **Espressione chiara delle modifiche**:
   - Elimina il vecchio contenuto, aggiungi quello nuovo
   - Esempio: ~~versione errata~~ versione corretta
   
2. **Uso conciso**:
   - Evita troppo testo barrato che compromette la leggibilità
   - Valuta se è davvero necessario mantenere il vecchio contenuto
   
3. **Combina con altri marker**:
   - Usa con le checkbox negli elenchi di attività
   - Combina con altri formati per aumentare l'espressività

❌ Pratiche da evitare:

1. Usare formattazioni troppo complesse all'interno del barrato
2. Applicare il barrato a grandi blocchi di testo (riduce la leggibilità)
3. Abusare dell'umorismo barrato in documenti importanti
4. Applicare il barrato a interi documenti o più paragrafi

Considerazioni sull'Accessibilità

Il barrato può confondere gli utenti di screen reader. Considera quanto segue:

1. Aggiungi spiegazioni contestuali per il contenuto barrato
2. Valuta l'uso di altri metodi (come parentesi, commenti) per indicare contenuto deprecato
3. Se il contenuto non è più rilevante, valuta di eliminarlo del tutto invece di barrarlo

<!-- Scrittura più accessibile -->
Scadenza progetto: 15 marzo (aggiornato: era previsto per il 1 marzo)

<!-- Invece di -->
Scadenza progetto: ~~1 marzo~~ 15 marzo

Soluzioni ai Problemi Comuni

Barrato Non Visualizzato

Se il barrato non viene visualizzato correttamente:

1. Assicurati di usare due tilde ~~, non una ~
2. Verifica che non ci siano spazi tra le tilde e il testo (non dovrebbero esserci)
3. Controlla che il tuo processore Markdown supporti la sintassi del barrato
4. Prova a usare i tag HTML <del> come alternativa

Problemi con Formattazione Complessa

Quando il barrato è combinato con altri formati, possono sorgere problemi:

<!-- Scrittura potenzialmente problematica -->
~~**[Formattazione complessa](https://www.markdownlang.com)**~~

<!-- Scrittura più sicura -->
<del>**[Formattazione complessa](https://www.markdownlang.com)**</del>

Barrato su Più Paragrafi

Per barrato che deve coprire più paragrafi, è meglio usare HTML:

<del>
Questo è il primo paragrafo eliminato.

Questo è il secondo paragrafo eliminato.
</del>

Sintassi Correlata

• Elenchi di Attività - Crea elenchi di attività interattivi
• Enfasi - Sintassi enfasi testo (grassetto, corsivo)
• HTML - Uso di HTML in Markdown

Sommario

Il barrato è una sintassi estesa semplice ma potente che offre un modo intuitivo per rappresentare modifiche, attività completate o informazioni obsolete. Un uso ragionevole del barrato rende i documenti più chiari e vivaci, aiutando i lettori a comprendere meglio l'evoluzione dei contenuti.