Partage via

Présentation de la référence Markdown sur Microsoft Q&A

  • Article

Microsoft Q&A s’appuie sur une riche expérience d’éditeur web. Vous n’avez donc jamais à vous soucier de la modification du contenu dans Markdown. Si vous le modifiez voici une référence pour l’écriture Markdown sur Q&A.

Markdown est un langage de balisage léger avec une syntaxe de mise en forme en texte brut. learn.microsoft.com (Learn) prend en charge l’analyse Markdown conforme à CommonMark par le biais du moteur d’analyse Markdig. Learn et Q&A prennent également en charge les extensions de personnalisation Markdown qui offrent des contenus plus riche sur le site. Q&A utilise un sous-ensemble des extensions prises en charge dans la documentation de Learn. Cet article fournit une référence alphabétique.

Pour avoir plus d’informations, consultez l’article référence Learn Markdown.

Extraits de code

Bloc de citation

> This example is a blockquote. It's usually rendered indented and with a different background color.

L’exemple précédent s’affiche comme suit :

Il s’agit d’un bloc de citation. Il est généralement affiché en retrait et avec une couleur d’arrière-plan différente.

Blocs de code

Vous pouvez ajouter le langage de code sur un bloc de code pour un rendu plus riche.

```csharp
    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }
    ```

L’exemple précédent s’affiche comme suit :

    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }

Emojis

Q&A convertit un code court emoji en caractères Unicode correspondants :

This is a test with a :).

L’exemple précédent s’affiche comme suit :

Il s’agit d’un test avec un 😃.

Mise en forme

Pour mettre en forme le texte en gras, entourez-le de deux astérisques :

This text is **bold**.

Pour mettre en forme le texte en italique, entourez-le d’un seul astérisque :

This text is *italic*.

Pour mettre en forme le texte en gras et en italique, entourez-le de trois astérisques :

This text is both ***bold and italic***.

Pour mettre en forme le texte barré, placez-le entre deux tildes :

This text is ~~strikeout~~.

En-têtes

Q&A prend en charge six niveaux de titres Markdown :

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)
  • Il doit y avoir un espace entre le signe # et le texte du titre.
  • Chaque question, réponse ou commentaire doit avoir un seul titre de niveau H1.

HTML

Si vous entrez du contenu HTML, le contenu ne s’affiche pas. Au lieu de cela, il se présente sous forme de texte brut.

Images

L’extension de personnalisation :::image::: sur Learn prend en charge les images standard, les images complexes et les icônes.

:::image source="<folderOrURLPath>" alt-text="<alt text>":::

Où <alt text> est une brève description de l’image et <folderOrURLPath> le chemin d’accès relatif à l’image ou à son URL. Le texte de remplacement est nécessaire pour les lecteurs d’écran des personnes déficientes visuelles. Ce texte est également utile si le site contient un bogue qui empêche l’affichage de l’image. Ne copiez pas les noms de fichiers pour les utiliser comme texte de remplacement. Par exemple, au lieu de :

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::

Écrivez ceci :

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::

Les liens sont faciles à ajouter dans Q&A. Les liens dirigent les utilisateurs vers le contenu d’une autre page dans Q&A ou d’une autre source approuvée.

[Link text](<FullURL>).

[Microsoft Q&A products page](/answers/products).`

Texte du lien

Les mots que vous incluez dans le texte du lien doivent être conviviaux. En d’autres termes, il doit s’agir de mots simples ou du titre de la page vers laquelle vous établissez le lien.

N’utilisez pas « sélectionner ici » pour le texte du lien. Ce n’est pas bon pour l’optimisation du référencement d’un site auprès d’un moteur de recherche et cela ne décrit pas correctement la cible.

Important

Tous les liens doivent être sécurisés (https et http) lorsque la cible le permet (dans la grande majorité des cas).

Exemple :

For more information, see the [Microsoft Q&A products page](/answers/products).

L’exemple ci-dessus s’affiche comme suit :

Pour plus d’informations, consultez la page Produits Microsoft Q&A.

Les liens sont mis en forme automatiquement pour toute chaîne qui commence par : https://, https://, ftp://, mailto:, tel: ou www. (se résout en https://www.)

Listes (à numéros, à puces)

Liste numérotée

Pour créer une liste numérotée, vous pouvez utiliser uniquement des 1. Les nombres sont affichés dans l’ordre croissant sous la forme d’une liste séquentielle au moment de la publication. Pour améliorer la lisibilité de la source, vous pouvez augmenter vos listes manuellement.

N’utilisez pas de lettres dans les listes, y compris dans les listes imbriquées. Elles ne s’affichent pas correctement lors de la publication. Les listes imbriquées utilisant des nombres sont restituées avec des lettres minuscules au moment de la publication. Par exemple :

1. This is
1. a parent numbered list
   1. and this is
   1. a nested numbered list
1. (fin)

Ce code est restitué comme suit :

  1. This is
  2. une liste numérotée parente
    1. and this is
    2. a parent numbered list
  3. (fin)

Liste à puces

Pour créer une liste à puces, utilisez - ou * suivi d’un espace au début de chaque ligne :

- This is
- a parent bulleted list
  - and this is
  - a nested bulleted list
- All done!

Ce code est restitué comme suit :

  • This is
  • une liste à puces parente
    • and this is
    • a nested bulleted list
  • Vous avez terminé.

Quelle que soit la syntaxe que vous choisissez, - ou *, utilisez-la de manière cohérente dans votre contenu.

Tables

Le moyen le plus simple de créer un tableau en Markdown est d’utiliser des barres verticales et des lignes. Pour créer un tableau standard avec un en-tête, faites suivre la première ligne d’une ligne en pointillés :

|This is   |a simple   |table header|
|----------|-----------|------------|
|table     |data       |here        |
|it doesn't|actually   |have to line up nicely!|

Ce code est restitué comme suit :

This is a simple table header
table data ici
it doesn't actually have to line up nicely!