Partage 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? nouvelle ligne entre 2 phrases
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 avec en-têtes Markdown
format avec en-têtes Markdown H1 à H5
Italique *text* How do I create a bot with *QnA Maker*? format en italique
Fort (gras) **text** How do I create a bot with **QnA Maker**? format avec un marquage renforcé pour le gras
URL du lien [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? format pour l’URL (lien hypertexte)
*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 de l’URL de l’image publique
Barré ~~text~~ some ~~questoins~~ questions need to be asked format barré
Gras et italique ***text*** How can I create a ***QnA Maker*** bot? format pour le gras et l’italique
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 de l’URL en gras
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 de l’URL en italique
Ajouter un caractère d’échappement devant les symboles Markdown \*text\* How do I create a bot with \*QnA Maker\*? Format d’un caractère d’échappement devant les symboles Markdown
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 de la liste triée
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 de la liste triée
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 de la liste non triée imbriquée
format de la liste triée imbriquée

*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.