Format języka Markdown obsługiwany w tekście odpowiedzi usługi QnA Maker
Usługa QnA Maker przechowuje tekst odpowiedzi jako markdown. Istnieje wiele smaków języka Markdown. Aby upewnić się, że tekst odpowiedzi jest zwracany i wyświetlany poprawnie, użyj tego odwołania.
Użyj samouczka CommonMark , aby zweryfikować język Markdown. Samouczek zawiera funkcję Wypróbuj, aby przeprowadzić szybką walidację kopiowania/wklejania.
Kiedy należy używać edycji tekstu sformatowanych w porównaniu z markdown
Edytowanie odpowiedzi w tekście sformatowanym umożliwia, jako autorowi, używanie paska narzędzi formatowania w celu szybkiego zaznaczenia i sformatowania tekstu.
Markdown to lepsze narzędzie, gdy trzeba automatycznie wygenerować zawartość w celu utworzenia baza wiedzy do zaimportowania w ramach potoku ciągłej integracji/ciągłego wdrażania lub testowania wsadowego.
Obsługiwany format markdown
Poniżej znajduje się lista formatów markdown, których można użyć w tekście odpowiedzi usługi QnA Maker.
Purpose | Formatuj | Przykładowy kod języka Markdown | Renderowanie jak pokazano w czatbotze |
---|---|---|---|
Nowa linia między 2 zdaniami. | \n\n |
How can I create a bot with \n\n QnA Maker? |
|
Nagłówki od h1 do h6, liczba # oznacza, który nagłówek. 1 # to 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 |
|
Kursywa | *text* |
How do I create a bot with *QnA Maker*? |
|
Silny (pogrubiony) | **text** |
How do I create a bot with **QnA Maker**? |
|
Adres URL linku | [text](https://www.my.com) |
How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? |
|
*Adres URL obrazu publicznego | ![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) |
|
Przekreślenie | ~~text~~ |
some ~~questoins~~ questions need to be asked |
|
Pogrubienie i kursywa | ***text*** |
How can I create a ***QnA Maker*** bot? |
|
Pogrubiony adres URL linku | [**text**](https://www.my.com) |
How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? |
|
Adres URL kursywy dla linku | [*text*](https://www.my.com) |
How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? |
|
Symbole ucieczki markdown | \*text\* |
How do I create a bot with \*QnA Maker\*? |
|
Lista uporządkowana | \n 1. item1 \n 1. item2 |
This is an ordered list: \n 1. List item 1 \n 1. List item 2 W poprzednim przykładzie użyto automatycznego numerowania wbudowanego w znaczniki markdown. This is an ordered list: \n 1. List item 1 \n 2. List item 2 W poprzednim przykładzie użyto jawnego numerowania. |
|
Listy nieuporządkowane | \n * item1 \n * item2 lub \n - item1 \n - item2 |
This is an unordered list: \n * List item 1 \n * List item 2 |
|
Listy zagnieżdżone | \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2 \n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2 Można zagnieżdżać uporządkowane i nieurządzane listy razem. \t Karta , wskazuje poziom wcięcia elementu podrzędnego. |
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 |
*Usługa QnA Maker nie przetwarza obrazu w żaden sposób. Jest to rola aplikacji klienckiej do renderowania obrazu.
Jeśli chcesz dodać zawartość przy użyciu interfejsów API aktualizacji/zastępowania baza wiedzy, a zawartość/plik zawiera tagi HTML, możesz zachować kod HTML w pliku, upewniając się, że otwieranie i zamykanie tagów jest konwertowane w formacie zakodowanym.
Zachowaj kod HTML | Reprezentacja w żądaniu interfejsu API | Reprezentacja w kb |
---|---|---|
Tak | < br> | <Br> |
Tak | < h3> nagłówek | <h3>nagłówek</h3> |
Ponadto funkcja CR LF(\r\n) jest konwertowana na \n w kb. LF(\n) jest zachowywany tak, jak to jest. Jeśli chcesz uniknąć jakiejkolwiek sekwencji ucieczki, takiej jak \t lub \n, możesz użyć ukośnika odwrotnego, na przykład: "\\r\\n" i "\\t"