Souligner en Markdown : ce qui fonctionne sur GitHub et ailleurs

Markdown ne possède pas de syntaxe native pour souligner le texte. Dans CommonMark et GitHub Flavored Markdown, _texte_ signifie italique et __texte__ signifie gras. Le soulignement nécessite généralement la prise en charge de HTML ou une extension propre à l’application.

Sur GitHub, la forme documentée est :

La <ins>nouvelle échéance</ins> est vendredi.

GitHub indique <ins>...</ins> pour le texte souligné dans sa documentation de mise en forme de base. Il s’agit d’une option HTML prise en charge par la plateforme, et non d’un nouveau délimiteur Markdown fonctionnant partout.

Comparaison du soulignement, du gras et de l’italique

Source	Signification	Où l’attendre
_important_	Emphase, généralement italique	CommonMark et GFM
__important__	Emphase forte, généralement gras	CommonMark et GFM
**important**	Emphase forte, généralement gras	CommonMark et GFM
<ins>texte ajouté</ins>	Texte inséré, généralement souligné	Moteurs autorisant HTML ; documenté par GitHub
<u>texte annoté</u>	Annotation HTML, généralement soulignée	Moteurs autorisant cet élément HTML

Choisissez le gras ou l’italique pour mettre l’accent sur un élément. Par exemple, **À rendre vendredi** reste utilisable dans un README, une note et un export Markdown sans dépendre du HTML brut.

Quelle différence entre ins et u ?

Les deux balises peuvent se ressembler visuellement, mais leur sens diffère.

<ins> représente du texte inséré dans un document. Il convient à une révision, telle qu’une exigence nouvellement ajoutée. Le navigateur le souligne habituellement, mais une feuille de styles peut changer son apparence. Consultez la référence MDN du texte inséré.

Cette version prend en charge <ins>les importations CSV et TSV</ins>.

<u> marque une annotation qui n’est pas une emphase ordinaire, par exemple pour signaler une faute d’orthographe. Le HTML moderne ne le définit pas comme une balise générique signifiant « rendre ceci important ». Consultez la référence MDN de l’élément u.

Veuillez vérifier l’orthographe de <u>acceuil</u>.

Si vous contrôlez un site et souhaitez un soulignement purement visuel, appliquez text-decoration: underline en CSS. Une plateforme Markdown hébergée peut supprimer les attributs de style ou interdire les styles personnalisés : cette approche n’est donc pas portable non plus.

Pourquoi le soulignement fonctionne-t-il dans un éditeur et disparaît-il dans un autre ?

Trois décisions sont distinctes : l’analyseur Markdown reconnaît HTML, l’application choisit les balises autorisées et la feuille de styles de destination définit leur apparence. Prendre en charge GFM ne garantit pas qu’un produit autorise toutes les balises HTML.

L’éditeur MD File Viewer supprime actuellement les balises HTML brutes des saisies utilisateur. Y coller <ins>texte ajouté</ins> ou <u>texte annoté</u> conserve les mots sans ces balises : l’aperçu ne les souligne donc pas. Utilisez cet aperçu pour la mise en forme Markdown prise en charge, et vérifiez celle fondée sur HTML à sa destination de publication.

Si vous transférez un document HTML vers Markdown, le convertisseur HTML vers Markdown aide à récupérer le texte, les titres, les liens et les listes. Le soulignement et le CSS personnalisé peuvent être perdus, car Markdown simple n’a pas de syntaxe équivalente. Vérifiez le résultat avant de remplacer le document original.

Exemples pour un README GitHub

Pour un bref ajout dans une note de modification, l’option HTML documentée par GitHub est :

Cette version ajoute <ins>une étape d’importation facultative</ins>.

Pour une échéance ou une exigence, utilisez l’emphase Markdown :

**Obligatoire :** Inclure une ligne d’en-tête dans le fichier CSV.

Pour une destination, utilisez un lien :

[Lire les instructions d’importation](https://example.com/import)

Le texte souligné peut ressembler à un lien cliquable. Évitez de donner une apparence interactive à des libellés ordinaires, surtout lorsque le même paragraphe contient de vrais liens. Le guide des liens Markdown traite des textes de lien descriptifs et des liens de référence.

Erreurs fréquentes de soulignement

Les doubles traits de soulignement mettent le texte en gras. Remplacer **mot** par __mot__ change le délimiteur, pas le sens. Les deux expriment une emphase forte.

Les accents graves affichent la balise comme du code. Écrire `<ins>texte</ins>` est utile dans un tutoriel, mais affiche volontairement le balisage au lieu de l’interpréter.

Les raccourcis clavier appartiennent à l’application. Un éditeur de texte enrichi peut proposer une commande de soulignement et enregistrer du HTML ou son propre format de document. Cela ne fait pas du soulignement une fonctionnalité du Markdown portable.

Un titre souligné est un autre concept. Dans cette source, les tirets créent un titre de niveau deux :

Notes de version
-------------

Ils ne soulignent pas une expression dans un paragraphe. Pour séparer des sections, utilisez une ligne horizontale Markdown entourée de lignes vides.

Questions fréquentes

Comment souligner en Markdown sur GitHub ?

Utilisez <ins>texte</ins>, que GitHub documente pour le soulignement. Pour une emphase fonctionnant aussi dans les moteurs sans HTML, utilisez plutôt **texte** ou *texte*.

Existe-t-il une alternative de soulignement uniquement en Markdown ?

Il n’existe pas de délimiteur standard de soulignement. Certaines applications ajoutent leur propre syntaxe, mais vous devez vérifier leur documentation et le format utilisé à l’exportation.

Le soulignement sera-t-il conservé lors d’une conversion Markdown vers PDF ou Word ?

Seulement si le convertisseur préserve le HTML ou l’extension concernés et prend en charge leur style. Ne supposez pas qu’un soulignement visible dans l’aperçu d’une application survivra à un autre exportateur. Inspectez le fichier obtenu, ou utilisez le gras standard lorsque la portabilité compte.

L’aide-mémoire Markdown fournit une référence compacte des mises en forme disposant de leur propre syntaxe Markdown.