Markdown-indeling ondersteund in QnA Maker-antwoordtekst

QnA Maker slaat antwoordtekst op als Markdown. Er zijn veel soorten Markdown. Gebruik deze verwijzing om ervoor te zorgen dat de antwoordtekst wordt geretourneerd en correct wordt weergegeven.

Gebruik de CommonMark-zelfstudie om uw Markdown te valideren. De zelfstudie heeft een functie Uitproberen voor snelle validatie van kopiëren/plakken.

Wanneer gebruikt u rtf-tekst bewerken versus Markdown

Met tekst met opmaak bewerken van antwoorden kunt u, als auteur, een opmaakwerkbalk gebruiken om snel tekst te selecteren en op te maken.

Markdown is een beter hulpmiddel wanneer u inhoud automatisch moet genereren om knowledge bases te maken die moeten worden geïmporteerd als onderdeel van een CI/CD-pijplijn of voor batchtests.

Ondersteunde Markdown-indeling

Hieronder volgt de lijst met markdown-indelingen die u kunt gebruiken in de antwoordtekst van QnA Maker.

Doel Notatie Voorbeeld voor Markdown Rendering
zoals weergegeven in de chatbot
Een nieuwe regel tussen 2 zinnen. \n\n How can I create a bot with \n\n QnA Maker? format new line between two sentences
Kopteksten van h1 tot h6, het aantal # geeft aan welke koptekst. 1 # is de 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
Cursief *text* How do I create a bot with *QnA Maker*? format with italics
Sterk (vet) **text** How do I create a bot with **QnA Maker**? format with strong marking for bold
URL voor koppeling [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? format for URL (hyperlink)
*URL voor openbare afbeelding ![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
Doorhalen ~~text~~ some ~~questoins~~ questions need to be asked format for strikethrough
Vet en cursief ***text*** How can I create a ***QnA Maker*** bot? format for bold and italics
Vetgedrukte URL voor koppeling [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? format for bold URL
Cursieve URL voor koppeling [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? format for italics URL
Escape Markdown-symbolen \*text\* How do I create a bot with \*QnA Maker\*? Format for escape markdown symbols.
Geordende lijst \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
In het voorgaande voorbeeld wordt automatische nummering gebruikt die is ingebouwd in Markdown.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
In het voorgaande voorbeeld wordt expliciete nummering gebruikt.
format for ordered list
Ongeordende lijst \n * item1 \n * item2
of
\n - item1 \n - item2
This is an unordered list: \n * List item 1 \n * List item 2 format for unordered list
Geneste lijsten \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

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

U kunt geordende en niet-geordende lijsten samen nesten. Het tabblad, \tgeeft het inspringingsniveau van het onderliggende element aan.
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 verwerkt de afbeelding op geen enkele manier. Het is de rol van de clienttoepassing om de afbeelding weer te geven.

Als u inhoud wilt toevoegen met behulp van knowledge base-API's bijwerken/vervangen en de inhoud/het bestand HTML-tags bevat, kunt u de HTML in uw bestand behouden door ervoor te zorgen dat het openen en sluiten van de tags in de gecodeerde indeling wordt geconverteerd.

HTML behouden Weergave in de API-aanvraag Weergave in KB
Ja < br> <Br>
Ja < h3> header <h3>header</h3>

Daarnaast worden CR LF(\r\n) geconverteerd naar \n in de KB. LF(\n) wordt bewaard zoals is. Als u een escape-reeks wilt ontsnappen, zoals een \t of \n, kunt u backslash gebruiken, bijvoorbeeld: '\\r\\n' en '\\t'

Volgende stappen

Controleer de bestandsindelingen voor batchtests.