Syntaxe de l'emphase

La syntaxe d'emphase permet de mettre en valeur du texte et constitue l'une des fonctionnalités de mise en forme les plus utilisées dans Markdown. En utilisant différentes méthodes d'emphase, vous pouvez faire ressortir les contenus importants.

Syntaxe de base de l'emphase

Italique

Utilisez un astérisque * ou un souligné _ pour entourer le texte :

*texte en italique*
_texte en italique_

Rendu :texte en italiquetexte en italique

Gras

Utilisez deux astérisques ** ou deux soulignés __ pour entourer le texte :

**texte en gras**
__texte en gras__

Rendu :texte en grastexte en gras

Gras et italique

Utilisez trois astérisques *** ou trois soulignés ___, ou mélangez-les :

***texte en gras italique***
___texte en gras italique___
**_texte en gras italique_**
*__texte en gras italique__*

Rendu :texte en gras italiquetexte en gras italiquetexte en gras italiquetexte en gras italique

Conseils de choix de syntaxe

Astérisque vs Souligné

Symbole	Avantage	Inconvénient	Scénario recommandé
*	Plus courant, meilleure compatibilité	Peut être confondu avec les listes dans certains éditeurs	Généralement recommandé
_	Plus clair à l'intérieur des mots	Moins utilisé, moins familier	Cas particuliers

Utilisation recommandée

✅ Recommandé : Restez cohérent
Voici du texte **gras** et *italique*.

❌ Non recommandé : Usage mixte
Voici du texte **gras** et _italique_.

Emphase à l'intérieur des mots

Limite de l'astérisque

Les astérisques peuvent ne pas être reconnus à l'intérieur des mots :

love*is*beautiful  ← peut ne pas être rendu en italique

Avantage du souligné

Le souligné est plus fiable à l'intérieur des mots :

love_is_beautiful  ← plus de chances d'être rendu correctement

Astuce : Si vous avez besoin d'emphase à l'intérieur des mots, privilégiez le souligné.

Emphase imbriquée

Imbrication de base

Vous pouvez imbriquer l'italique dans le gras, ou le gras dans l'italique :

**Ceci est du gras avec du texte *italique* à l'intérieur**
*Voici de l'italique avec du **gras** à l'intérieur*

Rendu :Ceci est du gras avec du texte italique à l'intérieurVoici de l'italique avec du gras à l'intérieur

Imbrication complexe

***Ceci est du gras italique avec du texte normal***
**Paragraphe en gras avec une *proposition en italique* et du texte normal**
*Paragraphe en italique avec un **mot-clé en gras** et du texte normal*

Rendu :Ceci est du gras italique avec du texte normalParagraphe en gras avec une proposition en italique et du texte normalParagraphe en italique avec un mot-clé en gras et du texte normal

Erreurs courantes et solutions

1. Symboles non appariés

❌ Incorrect :
*Ce texte n'est pas fermé en italique
**Ce texte est en gras non apparié*

✅ Correct :
*Ce texte est bien en italique*
**Ce texte est bien en gras**

2. Problèmes d'espaces

❌ Incorrect :
* ceci n'est pas en italique *
** ceci n'est pas en gras **

✅ Correct :
*ceci est en italique*
**ceci est en gras**

3. Caractères autour des symboles

❌ Problème potentiel :
Texte*italique*texte  ← peut ne pas être rendu

✅ Plus sûr :
Texte *italique* texte
Texte_italique_texte

Cas particuliers

Échapper les symboles d'emphase

Si vous souhaitez afficher des astérisques ou soulignés eux-mêmes, utilisez un antislash :

\*ceci n'est pas en italique\*
\**ceci n'est pas en gras\**
\_ceci n'est pas en italique\_

Rendu : *ceci n'est pas en italique* *ceci n'est pas en gras* _ceci n'est pas en italique_

Dans le code

Dans le code en ligne, les symboles d'emphase sont affichés littéralement :

`*l'astérisque ici ne sera pas interprété comme de l'italique*`
`**les doubles astérisques ici ne seront pas interprétés comme du gras**`

Rendu :*l'astérisque ici ne sera pas interprété comme de l'italique***les doubles astérisques ici ne seront pas interprétés comme du gras**

Utilisation sémantique

Usages sémantiques de l'italique

• Emphase : Ceci est important
• Mots étrangers : Hello World
• Termes : Protocole HTTP
• Citations : Comme indiqué dans « Les Trois Royaumes »
• Variables : Attribuez x à 10

Usages sémantiques du gras

• Importance : Faites attention à la sécurité
• Mots-clés : Point d'accès API
• Avertissement : Ne supprimez pas les fichiers importants
• Sous-titres : Étape un : Installez le logiciel

Usages du gras italique

• Extrêmement important : Ne jamais faire cela
• Forte recommandation : Il est fortement recommandé de lire la documentation

Bonnes pratiques

1. Utilisez avec modération

✅ Recommandé : Emphase modérée
Cette fonctionnalité est **très importante**, veuillez lire la documentation attentivement.

❌ Non recommandé : Sur-emphase
**Cette fonctionnalité*****est très importante***,**veuillez lire****la documentation**.

2. Restez cohérent

✅ Recommandé : Toujours utiliser les astérisques
Utilisez **gras** et *italique* pour mettre en valeur le contenu.

❌ Non recommandé : Symboles mélangés
Utilisez **gras** et _italique_ pour mettre en valeur le contenu.

3. Utilisez sémantiquement

✅ Recommandé : Emphase porteuse de sens
La fonction retourne **true** en cas de succès et **false** en cas d'échec.

❌ Non recommandé : Emphase décorative
La fonction**retourne** true **signifie** succès, **retourne** false **signifie** échec.

Sortie HTML

La syntaxe d'emphase Markdown est convertie en HTML :

*italique*     → <em>italique</em>
**gras**   → <strong>gras</strong>
***gras italique*** → <strong><em>gras italique</em></strong>

Syntaxe étendue

Certains moteurs Markdown prennent en charge des méthodes d'emphase supplémentaires :

Barré

~~texte barré~~

Rendu :texte barré

Souligné

<u>texte souligné</u>

Rendu :texte souligné

Surlignage

==texte surligné==  (supporté par certains moteurs)
<mark>texte surligné</mark>  (balise HTML)

Exemples pratiques

Documentation technique

**Point d'accès API** : `/api/users`

**Méthode** : *GET*

**Paramètres** :
- *id* (***obligatoire***): ID utilisateur
- *format* (optionnel): Format de retour

**Retour** : Infos utilisateur ou **message d'erreur**

Guide utilisateur

## Étapes d'installation

**Étape un** : Téléchargez l'installeur

Rendez-vous sur la page de téléchargement du site officiel et choisissez la version adaptée à votre système. *Assurez-vous de télécharger la dernière version*.

**Étape deux** : Lancez l'installeur

Double-cliquez sur le fichier téléchargé et suivez l'assistant pour terminer l'installation. ***Important*** : Veuillez désactiver l'antivirus pendant l'installation.

**Étape trois** : Vérifiez l'installation

Ouvrez la ligne de commande et tapez `app --version` pour vérifier si l'installation a réussi.

Syntaxes associées

• Syntaxe des liens – Création de liens hypertextes
• Syntaxe du code – Mise en forme du code
• Syntaxe des citations – Citer du texte
• Barré – Emphase étendue

Pratique

Essayez de créer un document avec les éléments suivants :

1. Une présentation produit mettant en gras les fonctionnalités clés
2. Une explication technique mettant en italique les termes
3. Un message d'avertissement utilisant le gras italique pour l'importance
4. Des phrases composées mélangeant divers styles d'emphase