Définir le contenu à livrer
Un article peut demander titres, prose, listes et libellés ; une vérification du code source peut aussi inclure syntaxe, URL et programmes. Avant nettoyage, consignez « article converti, titre inclus, code exclu » ou « source complète livrée ». Le compteur mesure le texte collé. Un écart avec l’aperçu ne prouve pas automatiquement une mauvaise reconnaissance des mots.
Les titres peuvent changer les caractères sans changer les mots
Le texte italien exact ## Gatto **nero** compte dix-sept caractères et deux mots ici ; Gatto nero, dix et deux. Cela ne démontre pas que tout Markdown conserve les mots. D’autres constructions ajoutent des destinations ou termes techniques ; les astérisques peuvent être littéraux. CommonMark définit leurs rôles : inspectez le véritable aperçu et les ambiguïtés avant de supprimer les symboles.
Séparer libellés et URL
Le texte exact [Leggi qui](https://esempio.test/guida) compte trente-neuf caractères et six mots ici. Le libellé visible Leggi qui en compte neuf et deux ; les mots supplémentaires viennent des segments d’URL. Convenez de l’inclusion des destinations pour limites ou facturation. Les définitions de référence hors du corps n’entrent pas automatiquement dans une copie de prose. Vérifiez aussi les titres descriptifs.
Décider du code à inclure
Variables, commentaires, chaînes et commandes peuvent constituer rédaction, démonstration ou annexes. Pour une limite de prose, excluez les blocs et consignez le choix. Un timeout intégré à une instruction peut rester nécessaire alors qu’un long listing est exclu. Distinguez délimiteurs, citations et indentation. Les extensions au-delà de CommonMark exigent de vérifier la publication réelle.
Descriptions alternatives et légendes
Une référence d’image contient description alternative et chemin, sans être automatiquement une légende visible. Un inventaire accessible peut compter ces descriptions séparément. Séparez corps, légendes, alternatives et métadonnées pour éviter les doublons à la conversion. Les mots dessinés peuvent manquer dans Markdown : transcrivez ceux demandés et précisez leur origine, sans les estimer depuis le nom du fichier.
Préparer une copie lisible
Convertissez dans l’environnement prévu, sélectionnez le périmètre convenu et copiez comme texte. Contrôlez titres, listes et liens : les séparateurs transférés varient. Un travail répété peut nécessiter un analyseur compatible. Effacer toutes les parenthèses supprime explications et formules ; retirer tous les # ou * détruit des exemples littéraux. Relisez code, liens et citations après conversion.
Vérifier les extensions du format
Le suffixe .md ne fixe pas les extensions de tableaux, notes ou métadonnées. Un moteur les traite, un autre les affiche telles quelles. Définissez environnement de référence et exclusions. Ne comptez pas deux fois un titre également généré depuis les métadonnées. Pour les tableaux, précisez cellules et colonnes incluses, notamment les codes produit dont le traitement diffère de la prose.
Expliquer les différences de périmètre
Conservez des copies nommées distinctes du code et du texte éditorial si les deux comptent. Des écarts dans les URL ou listings orientent vers les inclusions à revoir, sans réécrire la prose. Avant livraison, vérifiez un titre avec emphase, un lien et un bloc de code réels. Les totaux peuvent différer si chaque cause est expliquée. Consultez le comptage du texte HTML.
Code et texte lisible mesurés séparément
| Exemple | Caractères du site | Mots du site | Inclusion |
|---|---|---|---|
| ## Gatto **nero** | 17 | 2 | Syntaxe de titre et emphase |
| Gatto nero | 10 | 2 | Texte lisible |
| [Leggi qui](https://esempio.test/guida) | 39 | 6 | Libellé et URL |
| Leggi qui | 9 | 2 | Libellé seul |
Sources et vérifications
- CommonMark Specification 0.31.2 · Choisissez source Markdown ou texte converti, puis vérifiez liens, blocs de code et images inclus.