Barré

Le barré est une syntaxe d'extension dans Markdown utilisée pour indiquer un texte supprimé ou devenu obsolète. C'est très utile dans les révisions de documents, les listes de tâches, les changements de prix et d'autres scénarios.

Syntaxe de Base

Syntaxe Standard

En Markdown, le barré utilise généralement deux tildes (~~) pour entourer le texte à barrer :

Ceci est un exemple contenant du texte ~~barré~~.

Effet de Rendu :

Ceci est un exemple contenant du texte barré.

Mots et Phrases

Le barré peut s'appliquer à des mots ou à des phrases entières :

~~Cette phrase entière est barrée.~~

Nous aurons une réunion la semaine prochaine ~~lundi~~ mardi.

Effet de Rendu :

Cette phrase entière est barrée.

Nous aurons une réunion la semaine prochaine lundi mardi.

Utilisation Avancée

Combinaison avec d'autres formats

Le barré peut être combiné avec d'autres formats Markdown :

~~**Barré gras**~~

~~*Barré italique*~~

~~***Barré gras italique***~~

~~`Code barré`~~

~~[Lien barré](https://www.markdownlang.com)~~

Effet de Rendu :

Barré gras

Barré italique

Barré gras italique

Code barré

Lien barré

Paragraphes et Blocs

Dans certaines implémentations Markdown, le barré peut s'appliquer à des paragraphes ou blocs entiers :

~~
Ceci est un paragraphe entièrement supprimé.
Il peut contenir plusieurs lignes de contenu.
~~

Remarque : Tous les processeurs Markdown ne prennent pas en charge le barré sur plusieurs lignes. Pour du contenu sur plusieurs lignes, il est plus sûr d'appliquer la syntaxe barrée à chaque ligne individuellement.

Compatibilité et Différences d'Implémentation

Prise en Charge selon les Plateformes

Plateforme/Outil	Barré supporté	Syntaxe
GitHub Markdown	✅	~~barré~~
GitLab Markdown	✅	~~barré~~
Stack Overflow	✅	~~barré~~
Discord	✅	~~barré~~
Reddit	✅	~~barré~~
CommonMark	✅	~~barré~~
VitePress	✅	~~barré~~
Pandoc	✅	~~barré~~

Format de Sortie HTML

La plupart des processeurs Markdown convertissent le barré en balises HTML <del> ou <s> :

<!-- Avec la balise <del> -->
<p>Ceci est un exemple contenant <del>texte barré</del>.</p>

<!-- Ou avec la balise <s> -->
<p>Ceci est un exemple contenant <s>texte barré</s>.</p>

Syntaxe Alternative

Certaines plateformes ou anciennes versions de Markdown peuvent prendre en charge d'autres syntaxes barrées :

<!-- Simple tilde (certaines plateformes) -->
~texte barré~

<!-- Balises HTML (tous les processeurs Markdown compatibles) -->
<del>texte barré</del>
<s>texte barré</s>

Cas d'Utilisation

Révisions de Documents

Le barré est couramment utilisé pour montrer les révisions et modifications :

# Plan de Projet v2.0

## Calendrier

- Analyse des besoins : ~~1-15 mars~~ 1-20 mars (retardé)
- Phase de conception : ~~16 mars-5 avril~~ 21 mars-10 avril
- Phase de développement : 11 avril-15 mai
- Phase de test : 16-30 mai
- Date de sortie : ~~1er juin~~ 15 juin

Effet de Rendu :

Plan de Projet v2.0

Calendrier

• Analyse des besoins : 1-15 mars 1-20 mars (retardé)
• Phase de conception : 16 mars-5 avril 21 mars-10 avril
• Phase de développement : 11 avril-15 mai
• Phase de test : 16-30 mai
• Date de sortie : 1er juin 15 juin

Listes de Tâches

Le barré combiné avec les cases à cocher permet de créer des listes de tâches plus intuitives :

## Tâches de la Semaine

- [x] ~~Rédiger la proposition de projet~~
- [x] ~~Rencontrer le client pour discuter des besoins~~
- [ ] Créer une maquette de design
- [ ] Rédiger le cahier des charges technique
- [ ] Préparer l'estimation budgétaire

Effet de Rendu :

Tâches de la Semaine

• [x] Rédiger la proposition de projet
• [x] Rencontrer le client pour discuter des besoins
• [ ] Créer une maquette de design
• [ ] Rédiger le cahier des charges technique
• [ ] Préparer l'estimation budgétaire

Tarifs et Promotions

Le barré est très utile dans le commerce électronique et les contenus promotionnels :

## Offres Spéciales

- Ordinateur portable haute performance : ~~8 999 €~~ 7 499 €
- Casque sans fil : ~~1 299 €~~ 999 €
- Montre connectée : ~~2 499 €~~ 1 999 €

*Promotion valable jusqu'au 31 décembre 2023*

Effet de Rendu :

Offres Spéciales

• Ordinateur portable haute performance : 8 999 € 7 499 €
• Casque sans fil : 1 299 € 999 €
• Montre connectée : 2 499 € 1 999 €

Promotion valable jusqu'au 31 décembre 2023

Humour et Accentuation

Le barré est parfois utilisé pour exprimer de l'humour ou de l'accentuation :

La réunion d'aujourd'hui était ~~très ennuyeuse~~ très productive.

Je ~~déteste~~ adore rédiger la documentation.

Ce projet ~~pourrait échouer~~ va certainement réussir !

Effet de Rendu :

La réunion d'aujourd'hui était très ennuyeuse très productive.

Je déteste adore rédiger la documentation.

Ce projet pourrait échouer va certainement réussir !

Bonnes Pratiques

Recommandations d'Utilisation

✅ Pratiques recommandées :

1. **Expression claire des modifications** :
   - Supprimer l'ancien contenu, ajouter le nouveau
   - Exemple : ~~mauvaise version~~ version correcte
   
2. **Utilisation concise** :
   - Éviter trop de contenu barré qui nuit à la lisibilité
   - Se demander si l'ancien contenu doit vraiment être conservé
   
3. **Combiner avec d'autres marqueurs** :
   - Utiliser avec les cases à cocher dans les listes de tâches
   - Combiner avec d'autres formats pour plus d'expressivité

❌ À éviter :

1. Utiliser des formats trop complexes dans le barré
2. Appliquer le barré à de grands blocs de texte (nuit à la lisibilité)
3. Surutiliser l'humour barré dans des documents importants
4. Appliquer le barré à des documents entiers ou plusieurs paragraphes

Accessibilité

Le barré peut perturber les utilisateurs de lecteurs d'écran. Considérez les points suivants :

1. Ajouter des explications contextuelles pour le contenu barré
2. Utiliser d'autres méthodes (parenthèses, commentaires) pour indiquer un contenu obsolète
3. Si le contenu n'est vraiment plus pertinent, envisagez de le supprimer complètement plutôt que de le barrer

<!-- Meilleure accessibilité -->
Date limite du projet : 15 mars (mis à jour : initialement prévu le 1er mars)

<!-- Au lieu de -->
Date limite du projet : ~~1er mars~~ 15 mars

Solutions aux Problèmes Courants

Barré Non Affiché

Si votre barré ne s'affiche pas correctement :

1. Vérifiez que vous utilisez bien deux tildes ~~ et non un seul ~
2. Vérifiez qu'il n'y a pas d'espaces entre les tildes et le texte (il ne doit pas y en avoir)
3. Vérifiez que votre processeur Markdown prend en charge la syntaxe barrée
4. Essayez d'utiliser les balises HTML <del> comme alternative

Problèmes de Formatage Complexe

Lorsque le barré est combiné avec d'autres formats, des problèmes peuvent survenir :

<!-- Écriture potentiellement problématique -->
~~**[Formatage complexe](https://www.markdownlang.com)**~~

<!-- Écriture plus sûre -->
<del>**[Formatage complexe](https://www.markdownlang.com)**</del>

Barré Multi-paragraphe

Pour barrer plusieurs paragraphes, il est préférable d'utiliser du HTML :

<del>
Ceci est le premier paragraphe supprimé.

Ceci est le second paragraphe supprimé.
</del>

Syntaxe Connexe

• Listes de Tâches - Créer des listes de tâches interactives
• Emphase - Syntaxe d'emphase (gras, italique)
• HTML - Utiliser du HTML dans Markdown

Résumé

Le barré est une syntaxe d'extension Markdown simple mais puissante qui offre un moyen intuitif de représenter des modifications de texte, des tâches terminées ou des informations obsolètes. Un usage raisonné du barré rend les documents plus clairs et vivants, aidant les lecteurs à mieux comprendre l'évolution du contenu.