Identifier une véritable enveloppe

La première clôture doit précéder tout le document et la dernière le terminer. Si du texte existe avant ou après, l’opération n’est plus sûre.

Reconnaître l’ouverture extérieure

Une enveloppe générée par un assistant commence souvent par ```markdown ou ```md, avant le premier titre. Le libellé indique la coloration du bloc dans la conversation ; il ne doit pas devenir le début du fichier .md.

Vérifier la fermeture finale

La clôture extérieure doit être le dernier élément utile du texte. Si une phrase ou une autre clôture suit, examinez la structure manuellement avant toute suppression.

Conserver les blocs internes

Un exemple de code au milieu du document doit rester clôturé. Supprimer toutes les lignes ``` casserait sa structure.

Ne pas retirer un véritable exemple de code

Un document peut légitimement ne contenir qu’un bloc de code. Dans ce cas, les clôtures décrivent le contenu et ne constituent pas une enveloppe superflue.

Appliquer une règle déterministe

Retirez uniquement une paire extérieure reconnue qui englobe tout le document. N’utilisez pas un remplacement global sur chaque ligne contenant trois accents graves.

Contrôler les clôtures de quatre accents graves

Markdown permet d’utiliser une clôture plus longue lorsqu’un exemple contient déjà trois accents graves. Comparez la longueur des ouvertures et fermetures avant une correction manuelle.

Comparer avant et après

Vérifiez titres, blocs de code, tableaux et fin du fichier dans l’aperçu avant de remplacer la source.

Outils associés

Outil associéPoursuivez avec l’outil adapté dans le navigateur.Éditeur MarkdownPoursuivez avec l’outil adapté dans le navigateur.Aperçu MarkdownPoursuivez avec l’outil adapté dans le navigateur.Aide-mémoire MarkdownPoursuivez avec l’outil adapté dans le navigateur.
FAQ

Questions fréquentes

Puis-je supprimer toutes les lignes ``` ?

Non. Les clôtures internes peuvent délimiter du vrai code.

Le nettoyeur réécrit-il le contenu ?

Non. Il retire uniquement l’enveloppe externe lorsqu’elle est reconnue.

Que signifie ```markdown au début ?

Dans une conversation, ce libellé active surtout la coloration syntaxique du bloc de code.

Faut-il retirer un bloc qui contient seulement du code ?

Pas automatiquement. Il peut s’agir du contenu voulu, et non d’une enveloppe ajoutée autour d’un document.

Pourquoi ne pas utiliser un remplacement global ?

Parce qu’il supprimerait aussi les clôtures nécessaires aux exemples de code internes.

Que vérifier après le nettoyage ?

Contrôlez le premier titre, chaque bloc de code, les tableaux et la fin du document dans la source et l’aperçu.