Partager via


Format Markdown pris en charge dans le texte de réponse QnA Maker

QnA Maker stocke le texte de réponse au format Markdown. Il existe plusieurs saveurs de Markdown. Pour vérifier que le texte de réponse est retourné et correctement affiché, utilisez cette référence.

Utilisez le tutoriel CommonMark pour valider votre Markdown. Ce tutoriel a une fonctionnalité Essayer pour la validation rapide de copier/coller.

Choisir entre la modification de texte enrichi et Markdown

Modifier le texte enrichi de réponses vous permet, en tant qu’auteur, d’utiliser une barre d’outils de mise en forme pour sélectionner le texte et le mettre en forme rapidement.

Markdown est un outil plus approprié quand vous devez générer automatiquement du contenu pour créer des bases de connaissances à importer dans le cadre d’un pipeline CI/CD ou pour des tests par lots.

Format Markdown pris en charge

Voici la liste des formats Markdown que vous pouvez utiliser dans le texte de réponse de QnA Maker.

Objectif Format Exemple de Markdown Rendu
tel qu’il est affiché dans le bot de chat
Nouvelle ligne entre 2 phrases. \n\n How can I create a bot with \n\n QnA Maker? format new line between two sentences
En-têtes de H1 à H6. Le nombre de # dénote de quel en-tête il s’agit. 1 # correspond à H1. \n# text \n## text \n### text \n####text \n#####text ## Creating a bot \n ...text.... \n### Important news\n ...text... \n### Related Information\n ....text...

\n# my h1 \n## my h2\n### my h3 \n#### my h4 \n##### my h5
format with markdown headers
format with markdown headers H1 to H5
Italique *text* How do I create a bot with *QnA Maker*? format with italics
Fort (gras) **text** How do I create a bot with **QnA Maker**? format with strong marking for bold
URL du lien [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? format for URL (hyperlink)
*URL pour l’image publique ![text](https://www.my.com/image.png) How can I create a bot with ![QnAMaker](https://review.learn.microsoft.com/azure/ai-services/qnamaker/media/qnamaker-how-to-key-management/qnamaker-resource-list.png) format for public image URL
Barré ~~text~~ some ~~questoins~~ questions need to be asked format for strikethrough
Gras et italique ***text*** How can I create a ***QnA Maker*** bot? format for bold and italics
URL en gras pour le lien [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? format for bold URL
URL en italiques pour le lien [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? format for italics URL
Ajouter un caractère d’échappement devant les symboles Markdown \*text\* How do I create a bot with \*QnA Maker\*? Format for escape markdown symbols.
Liste triée \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
L’exemple précédent utilise la numérotation automatique intégrée au Markdown.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
L’exemple précédent utilise la numérotation explicite.
format for ordered list
Liste non triée \n * item1 \n * item2
or
\n - item1 \n - item2
This is an unordered list: \n * List item 1 \n * List item 2 format for unordered list
Listes imbriquées \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

\n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2

Vous pouvez imbriquer des listes triées et non triées ensemble. L’onglet, \t, indique le niveau de mise en retrait de l’élément enfant.
This is an unordered list: \n * List item 1 \n\t * Child1 \n\t * Child2 \n * List item 2

This is an ordered nested list: \n 1. Parent1 \n\t 1. Child1 \n\t 1. Child2 \n 1. Parent2
format for nested unordered list
format for nested ordered list

*QnA Maker ne traite pas du tout l’image. C’est le rôle de l’application cliente d’effectuer le rendu de l’image.

Si vous souhaitez ajouter du contenu à l’aide des API de mise à jour ou de remplacement de la base de connaissances, et si le contenu ou le fichier contiennent des balises HTML, vous pouvez conserver le code HTML de votre fichier en veillant à ce que l’ouverture et la fermeture des balises soient converties au format encodé.

Conserver le code HTML Représentation de la requête d’API Représentation dans la base de connaissances
Oui < br> <br>
Oui < h3> header <h3>header</h3>

En outre, CR LF (\r\n) est converti en \n dans la base de connaissances. LF (\n) est conservé tel quel. Si vous souhaitez échapper une séquence d’échappement telle que \t ou \n, vous pouvez utiliser la barre oblique inverse, par exemple : « \\r\\n » et « \\t ».

Étapes suivantes

Passez en revue les formats de fichiers des tests par lots.