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? |
|
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 |
|
Cursief | *text* |
How do I create a bot with *QnA Maker*? |
|
Sterk (vet) | **text** |
How do I create a bot with **QnA Maker**? |
|
URL voor koppeling | [text](https://www.my.com) |
How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? |
|
*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) |
|
Doorhalen | ~~text~~ |
some ~~questoins~~ questions need to be asked |
|
Vet en cursief | ***text*** |
How can I create a ***QnA Maker*** bot? |
|
Vetgedrukte URL voor koppeling | [**text**](https://www.my.com) |
How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? |
|
Cursieve URL voor koppeling | [*text*](https://www.my.com) |
How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? |
|
Escape Markdown-symbolen | \*text\* |
How do I create a bot with \*QnA Maker\*? |
|
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. |
|
Ongeordende lijst | \n * item1 \n * item2 of \n - item1 \n - item2 |
This is an unordered list: \n * List item 1 \n * List item 2 |
|
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, \t geeft 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 |
*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.