Formatage de texte avec Markdown

Markdown est un langage de balisage simple que vous pouvez utiliser pour ajouter facilement du formatage, des liens et des images à du texte brut. Vous pouvez l’utiliser aux endroits suivants :

• Commentaires de tickets (dans l’interface d’agent)
• Macros
• Signatures d’agent
• Contenu dynamique
• Blocs de contenu dans les articles du centre d’aide

Les commandes Markdown sont automatiquement prises en charge par votre éditeur de tickets. Vous pouvez saisir des commentaires avec Markdown pour formater votre contenu ou vous pouvez utiliser la barre d’outils de formatage pour ajouter du contenu riche. Consultez le tableau 1 ci-dessous pour prendre connaissance des commandes Markdown prises en charge.

Remarque – Markdown n’est pas disponible dans les e-mails ni les modèles d’e-mails. Si vous saisissez du texte avec la syntaxe Markdown, le formatage ne sera pas rendu et le texte restera tel quel.

Sujets abordés dans cet article :

• Ajout de code Markdown à du texte
  • Gras
  • Italique
  • Listes à puces
  • Listes numérotées
  • Listes imbriquées
  • Titres
  • Blocs de citation
  • Code incorporé
  • Blocs de code
  • Images
  • Liens
  • Images servant de liens
  • Liens vers les tickets
  • Ligne de séparation horizontale
  • Saut de ligne
• Aperçu du code Markdown dans les commentaires de tickets

Ajout de code Markdown à du texte

Le tableau suivant montre des exemples d’utilisation de code Markdown pour ajouter du formatage commun. Vous n’avez pas besoin d’afficher un aperçu de votre formatage. Votre contenu est formaté automatiquement au fur et à mesure que vous saisissez les commandes Markdown.

Remarque – Ces exemples vous montrent une méthode d’ajout de certains types de formatage. D’autres méthodes existent probablement pour effectuer ces types de formatage. Le langage Markdown dispose par ailleurs de nombreuses autres options de formatage. Pour en savoir plus, consultez la documentation complète de la syntaxe Markdown.

Vous pouvez aussi regarder cette courte vidéo.

Tableau  1. Exemples de syntaxe Markdown

Formatage	Texte saisi	Texte publié	Commentaires
Gras	Voici comment obtenir du texte en **gras**.		Pris en charge
Italique	Voici comment obtenir du texte en *italique*.		Pris en charge
Listes à puces	* Puce 1 (ne pas oublier l’espace après l’astérisque) * Puce 2 Remarque – Vous devez entrer un saut de ligne avant et après la liste.		Prises en charge. Vous pouvez aussi commencer par un tiret (-) suivi d’un espace pour créer une liste à puces.
Listes numérotées	1. Étape 1 2. Étape 2 Remarque – N’utilisez pas de hashtag (#) quand vous créez des listes numérotées dans Markdown, car ce symbole est utilisé pour d’autres options de formatage. Remarque – Vous devez entrer un saut de ligne avant et après la liste.		Prises en charge
Listes imbriquées	* Premier niveau de cette liste. * Pour créer un second niveau, ajoutez deux espaces avant l’astérisque ou le numéro. Remarque – Vous pouvez ajouter des images, des blocs de citation ou des liens à une liste imbriquée, en plus du texte. Remarque – Vous devez entrer un saut de ligne avant et après la liste.		Prises en charge, sauf pour les blocs de contenu. Pour créer un second niveau, appuyez sur la touche de tabulation après la liste numérotée ou à puces.
Titres	# Titre de niveau 1 (avec un espace après #) ## Titre de niveau 2 ### Titre de niveau 3 Remarque – Vous pouvez ajouter une ligne de signes = (égal) sous une ligne de texte pour créer le titre niveau 1 et une ligne de - (tirets) sous une ligne de texte pour créer le titre niveau 2.		Pris en charge. Jusqu’à 4 niveaux de titre. Jusqu’à 6 niveaux de titre dans les blocs de contenu.
Blocs de citation	> Les blocs de citation doivent commencer et finir par une ligne vierge > Chaque ligne de la citation commence par un crochet droit et un espace		Prises en charge
Code incorporé	Voici du `code incorporé.`		Prises en charge
Blocs de code	``` Voici un bloc de code. ``` Remarque – En créant une ligne vierge, puis en ajoutant quatre espaces au début de la ligne ou des lignes suivantes, vous créez également un bloc de code. Remarque – Vous devez entrer un saut de ligne avant et après le bloc de code.		Pris en charge. Pour quitter un bloc de code placé à la fin d’un commentaire, appuyez sur la touche Retour trois fois d’affilée.
Images	 Conseil – Pour incorporer une image non hébergée, commencez par joindre l’image au ticket. Ouvrez ensuite la pièce jointe, faites un clic droit sur l’image, sélectionnez Copier l’URL de l’image, puis utilisez ce lien pour incorporer votre image. Inopérant si les pièces jointes privées sont activées.		Prises en charge, sauf pour les blocs de contenu. L’ajout d’une URL d’image la convertit automatiquement en lien d’image. Quand le commentaire de ticket est envoyé, l’image s’affiche dans le journal de la conversation.
Liens	[Texte d’affichage du lien](http://www.sampleurl.com)		Pas encore de prise en charge
Images servant de liens	[](url lien)		Pas de prise en charge
Liens vers les tickets	Ceci a été traité dans le ticket 61.		Pas encore de prise en charge
Ligne de séparation horizontale	--- Remarque – Vous devez entrer un saut de ligne avant et après les tirets.		Prise en charge
Saut de ligne	Ligne 1   Ligne 2   Remarque – Vous devez entrer deux sauts de ligne avant chaque  .	Ligne 1 Ligne 2	Non pris en charge, sauf pour les blocs de contenu. Dans les blocs de contenu, appuyez sur Maj+Entrée pour ajouter un saut de ligne.
Trait de soulignement	Voici comment ajouter un \_trait de soulignement\_.	Voici comment souligner du texte.	Pris en charge dans les blocs de contenu uniquement.