Формат Markdown, поддерживаемый в тексте ответа QnA MakerMarkdown format supported in QnA Maker answer text

QnA Maker сохраняет текст ответа как Markdown.QnA Maker stores answer text as markdown. Существует множество разновидностей Markdown.There are many flavors of markdown. Чтобы убедиться, что текст ответа возвращен и отображается правильно, используйте эту ссылку.In order to make sure the answer text is returned and displayed correctly, use this reference.

Используйте CommonMark для проверки Markdown.Use the CommonMark tutorial to validate your Markdown. Руководство содержит функцию Попробовать для быстрой проверки копирования и вставки.The tutorial has a Try it feature for quick copy/paste validation.

Когда следует использовать редактирование RTF-текста и MarkdownWhen to use rich-text editing versus markdown

Редактирование ответов с помощью расширенного текста позволяет разработчику использовать панель инструментов форматирования для быстрого выбора и форматирования текста.Rich-text editing of answers allows you, as the author, to use a formatting toolbar to quickly select and format text.

Markdown — это лучшее средство, когда необходимо автоматически создавать содержимое для создания баз знаний, импортируемых в рамках конвейера CI/CD или для пакетного тестирования.Markdown is a better tool when you need to autogenerate content to create knowledge bases to be imported as part of a CI/CD pipeline or for batch testing.

Поддерживаемый формат MarkdownSupported markdown format

Ниже приведен список форматов Markdown, которые можно использовать в тексте ответа QnA Maker.Following is the list of markdown formats that you can use in QnA Maker's answer text.

НазначениеPurpose ФорматFormat Пример разметкиExample markdown ОтрисовкаRendering
как отображается в чате чатаas displayed in Chat bot
Новая строка из двух предложений.A new line between 2 sentences. \n\n How can I create a bot with \n\n QnA Maker? форматировать новую строку между двумя предложениями
Заголовки от H1 до H6, количество # определяет, какой заголовок.Headers from h1 to h6, the number of # denotes which header. 1 # — это H1.1 # is the 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
формат с заголовками Markdown
формат с заголовками Markdown от H1 до H5
КурсивItalics *text* How do I create a bot with *QnA Maker*? форматировать курсивом
Strong (полужирный)Strong (bold) **text** How do I create a bot with **QnA Maker**? формат с усиленной маркировкой для полужирного шрифта
URL-адрес для ссылкиURL for link [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? формат URL-адреса (гиперссылка)
* URL-адрес для общедоступного образа*URL for public image ![text](https://www.my.com/image.png) How can I create a bot with ![QnAMaker](https://review.docs.microsoft.com/azure/cognitive-services/qnamaker/media/qnamaker-how-to-key-management/qnamaker-resource-list.png) формат URL-адреса общедоступного образаformat for public image URL
ЗачеркнутыйStrikethrough ~~text~~ some ~~questoins~~ questions need to be asked формат для зачеркивания
Полужирный и курсивBold and italics ***text*** How can I create a ***QnA Maker*** bot? формат для полужирного шрифта и курсива
Полужирный URL-адрес для ссылкиBold URL for link [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? формат для URL-адреса полужирного шрифта
URL-адрес курсивов для ссылкиItalics URL for link [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? формат URL-адреса курсивов
Escape-символы MarkdownEscape markdown symbols \*text\* How do I create a bot with \*QnA Maker\*? формат URL-адреса курсивов
Упорядоченный списокOrdered list \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
В предыдущем примере используется автоматическая нумерация, встроенная в Markdown.The preceding example uses automatic numbering built into markdown.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
В предыдущем примере используется явная нумерация.The preceding example uses explicit numbering.
формат упорядоченного списка
Неупорядоченный списокUnordered list \n * item1 \n * item2
oror
\n - item1 \n - item2
This is an unordered list: \n * List item 1 \n * List item 2 формат неупорядоченного списка
Вложенные спискиNested lists \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

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

Упорядоченные и неупорядоченные списки можно вкладывать вместе.You can nest ordered and unordered lists together. Вкладка, \t указывает уровень отступа дочернего элемента.The tab, \t, indicates the indentation level of the child element.
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 не обрабатывает образ каким бы то ни было образом.*QnA Maker doesn't process the image in any way. Это роль клиентского приложения для отрисовки образа.It is the client application's role to render the image.

Если требуется добавить содержимое с помощью API обновления или замены базы знаний, а содержимое или файл содержит теги HTML, можно сохранить HTML в файле, убедившись, что открытие и закрытие тегов преобразуются в закодированном формате.If you want to add content using update/replace knowledge base APIs and the content/file contains html tags, you can preserve the HTML in your file by ensuring that opening and closing of the tags are converted in the encoded format.

Сохранить HTMLPreserve HTML Представление в запросе APIRepresentation in the API request Представление в КБRepresentation in KB
ДаYes &lt; br & gt;&lt;br&gt; <br><br>
ДаYes &lt; H3 & gt; заголовок & lt;/H3 & gt;&lt;h3&gt;header&lt;/h3&gt; <>/H3 заголовка < H3><h3>header</h3>

Кроме того, CR LF (\r\n) преобразуется в значение \n в КИЛОБАЙТах.Additionally, CR LF(\r\n) are converted to \n in the KB. LF (\n) сохраняется как есть.LF(\n) is kept as is. Если вы хотите экранировать любую escape-последовательность, например \t или \n, можно использовать обратную косую черту, например " \ \ r \ \ n" и " \ \ t".If you want to escape any escape sequence like a \t or \n you can use backslash, for example: '\\r\\n' and '\\t'

Следующие шагиNext steps

Просмотрите форматы файловпакетного тестирования.Review batch testing file formats.