A QnA Maker válaszszövegében támogatott Markdown-formátum
A QnA Maker markdownként tárolja a válaszszöveget. A markdownnak számos íze van. A válasz szövegének helyes visszaadásához és helyes megjelenítéséhez használja ezt a hivatkozást.
A Markdown ellenőrzéséhez használja a CommonMark oktatóanyagot. Az oktatóanyag egy Kipróbálás funkcióval rendelkezik a gyors másolás/beillesztés ellenőrzéséhez.
Mikor érdemes rich-text szerkesztést használni a markdown helyett?
A válaszok rich-text szerkesztése lehetővé teszi, hogy a szerző egy formázási eszköztár használatával gyorsan kijelölje és formázza a szöveget.
A Markdown jobb eszköz, ha automatikusan létre kell hoznia a tartalmat a CI/CD-folyamat részeként importálandó tudásbázis létrehozásához vagy kötegelt teszteléshez.
Támogatott markdown formátum
Az alábbiakban felsoroljuk a QnA Maker válaszszövegében használható markdown-formátumokat.
Cél | Format | Markdown-példa | Rendering a Csevegőrobotban látható módon |
---|---|---|---|
Egy új sor 2 mondat között. | \n\n |
How can I create a bot with \n\n QnA Maker? |
|
Fejlécek a h1-től a h6-osig, a fejlécek száma # . 1 # a 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 |
|
Dőlt | *text* |
How do I create a bot with *QnA Maker*? |
|
Erős (félkövér) | **text** |
How do I create a bot with **QnA Maker**? |
|
Hivatkozás URL-címe | [text](https://www.my.com) |
How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? |
|
*Nyilvános rendszerkép URL-címe | ![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) |
|
Áthúzott | ~~text~~ |
some ~~questoins~~ questions need to be asked |
|
Félkövér és dőlt | ***text*** |
How can I create a ***QnA Maker*** bot? |
|
Félkövér URL-cím a hivatkozáshoz | [**text**](https://www.my.com) |
How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? |
|
Dőlt URL-cím a hivatkozáshoz | [*text*](https://www.my.com) |
How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? |
|
Escape markdown szimbólumok | \*text\* |
How do I create a bot with \*QnA Maker\*? |
|
Rendezett lista | \n 1. item1 \n 1. item2 |
This is an ordered list: \n 1. List item 1 \n 1. List item 2 Az előző példa a markdownba beépített automatikus számozást használja. This is an ordered list: \n 1. List item 1 \n 2. List item 2 Az előző példa explicit számozást használ. |
|
Rendezetlen listák | \n * item1 \n * item2 vagy \n - item1 \n - item2 |
This is an unordered list: \n * List item 1 \n * List item 2 |
|
Beágyazott listák | \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2 \n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2 A rendezett és rendezetlen listákat egymásba ágyazhatja. A tabulátor \t a gyermekelem behúzási szintjét jelzi. |
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 |
*A QnA Maker semmilyen módon nem dolgozza fel a képet. A rendszerkép megjelenítéséhez az ügyfélalkalmazás feladata.
Ha tudásbázis API-k frissítésével/cseréjével szeretne tartalmat hozzáadni, és a tartalom/fájl HTML-címkéket tartalmaz, a html-kódot megőrizheti a fájlban úgy, hogy a címkék megnyitása és bezárása kódolt formátumban lesz konvertálva.
HTML megőrzése | Reprezentáció az API-kérelemben | Reprezentáció KB-ban |
---|---|---|
Igen | < br> | <Br> |
Igen | < h3> fejléc | <h3>fejléc</h3> |
Emellett a CR LF(\r\n) a KB-ban \n-re lesz konvertálva. Az LF(\n) a jelenlegi módon van megtartva. Ha meg szeretne szabadulni bármilyen menekülési sorozattól, például \t vagy \n, használhat fordított perjelet, például: "\\r\\n" és "\\\t"
További lépések
A kötegtesztelési fájlformátumok áttekintése.