Texte en gras

Les applications de discussion en Markdown, les fichiers README et de nombreux éditeurs de bases de connaissances traitent comme du gras une phrase entourée d'une paire d'astérisques doubles. On tape encore ces marqueurs à la main, on oublie la fermeture ou l'on colle un titre déjà entouré et l'on se retrouve avec quatre astérisques qui s'affichent en italique ou comme des étoiles littérales. Cet assistant de texte en gras prend une seule chaîne, refuse l'entrée vide ou uniquement composée d'espaces pour qu'une case blanche ne ressemble jamais à un format réussi, et renvoie la forme gras Markdown plus un indicateur lorsque la source était déjà entourée.

Ce qu'est le gras Markdown et comment cet entourage fonctionne

Le gras Markdown n'est pas un fichier de police et ce n'est pas un style de lettre Unicode. Dans CommonMark, GitHub Flavored Markdown, Discord, de nombreux aperçus README et d'innombrables générateurs de sites statiques, un passage entouré de deux astérisques de chaque côté est analysé comme emphase forte et rendu en gras. La même convention apparaît dans les macros de discussion, les modèles de ticket et les extraits de base de connaissances que les auteurs collent d'un outil à l'autre.

Cet assistant existe pour ce contrat : vous envoyez une chaîne brute et vous recevez cette chaîne entourée d'une paire initiale et d'une paire finale d'astérisques afin que le prochain moteur l'affiche en gras. Il ne projette pas A–Z sur des points de code Mathematical Bold Italic, n'émet pas de balises HTML strong et ne parcourt pas un document Markdown entier pour trouver chaque nœud d'emphase. Une chaîne en entrée, une chaîne marquée en sortie.

Lorsque la source rognée commence et se termine déjà par des astérisques doubles et que le passage intérieur n'est pas vide, la fonction laisse l'entourage existant en place au lieu d'empiler une seconde paire. Empiler transformerait un titre correct en quatre astérisques, que beaucoup d'analyseurs traitent comme de l'italique plus des étoiles orphelines ou comme une suite de délimiteurs cassée. Les chaînes vides ou uniquement composées d'espaces sont rejetées pour qu'une charge utile réussie ne signifie jamais que vous avez mis le néant en gras.

Où un entourage gras Markdown gagne sa place

Les responsables de communauté, les rédacteurs de support et les chaînes de documentation ont besoin d'un moyen minuscule et prévisible d'apposer du gras Markdown sur une phrase avant qu'elle n'atterrisse dans un message de discussion, une ligne de README ou un modèle de ticket. Les macros de tableur et les automatisations sans code qui construisent une copie compatible Discord peuvent appeler ce point d'accès au lieu de concaténer des astérisques selon cinq recettes qui ne s'accordent ni sur le rognage ni sur le double entourage.

Une validation échouée ne consomme pas de solde. Gardez les requêtes sous le plafond de caractères publié, figez la chaîne bold dans les tests et vous obtenez un balisage reproductible pour robots de discussion, générateurs de docs et workers de bord sans dresser un analyseur Markdown ni un moteur de polices. Utilisez Mathematical Bold Italic d'Unicode lorsque vous voulez des lettres qui paraissent grasses là où Markdown n'est pas analysé ; utilisez cette page lorsque le consommateur est un moteur Markdown qui attend des astérisques ASCII.

Cette scission d'intention de recherche explique qu'une page dédiée au texte en gras existe à côté du styliseur Unicode et de l'outil générique d'entourage par ligne.