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? format new line between two sentences
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
format with markdown headers
format with markdown headers H1 to H5
Kursywa *text* How do I create a bot with *QnA Maker*? format with italics
Silny (pogrubiony) **text** How do I create a bot with **QnA Maker**? format with strong marking for bold
Adres URL linku [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? format for URL (hyperlink)
*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) format for public image URL
Przekreślenie ~~text~~ some ~~questoins~~ questions need to be asked format for strikethrough
Pogrubienie i kursywa ***text*** How can I create a ***QnA Maker*** bot? format for bold and italics
Pogrubiony adres URL linku [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? format for bold URL
Adres URL kursywy dla linku [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? format for italics URL
Symbole ucieczki markdown \*text\* How do I create a bot with \*QnA Maker\*? Format for escape markdown symbols.
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.
format for ordered list
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 format for unordered list
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. \tKarta , 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
format for nested unordered list
format for nested ordered list

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

Następne kroki

Przejrzyj formaty plików testowania wsadowego.