Formato de redução com suporte no texto de resposta QnA MakerMarkdown format supported in QnA Maker answer text

QnA Maker armazena o texto de resposta como uma redução.QnA Maker stores answer text as markdown. Há muitos tipos de redução.There are many flavors of markdown. Para certificar-se de que o texto de resposta seja retornado e exibido corretamente, use essa referência.In order to make sure the answer text is returned and displayed correctly, use this reference.

Use o tutorial CommonMark para validar seu Markdown.Use the CommonMark tutorial to validate your Markdown. O tutorial tem um recurso Experimentar para validação rápida de copiar/colar.The tutorial has a Try it feature for quick copy/paste validation.

Quando usar edição de Rich Text versus reduçãoWhen to use rich-text editing versus markdown

A edição de respostas em Rich Text permite que você, como autor, use uma barra de ferramentas de formatação para selecionar e formatar rapidamente o texto.Rich-text editing of answers allows you, as the author, to use a formatting toolbar to quickly select and format text.

A redução é uma ferramenta melhor quando você precisa gerar o conteúdo automaticamente para criar bases de dados de conhecimento a serem importadas como parte de um pipeline de CI/CD ou para testes em lotes.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.

Formato de redução com suporteSupported markdown format

A seguir está a lista de formatos de redução que você pode usar no texto de resposta de QnA Maker.Following is the list of markdown formats that you can use in QnA Maker's answer text.

FinalidadePurpose FormatarFormat Exemplo de markdownExample markdown RenderizaçãoRendering
conforme exibido no bot de chatas displayed in Chat bot
Uma nova linha entre duas frases.A new line between 2 sentences. \n\n How can I create a bot with \n\n QnA Maker? Formatar nova linha entre duas frases
Cabeçalhos de H1 a H6, o número de # denota o cabeçalho.Headers from h1 to h6, the number of # denotes which header. 1 # é o 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
Formatar com cabeçalhos de redução
Formatar com cabeçalhos de redução H1 a H5
ItálicoItalics *text* How do I create a bot with *QnA Maker*? Formatar com itálico
Forte (negrito)Strong (bold) **text** How do I create a bot with **QnA Maker**? Formatar com marcação forte para negrito
URL para o linkURL for link [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? formato da URL (hiperlink)
* URL para imagem pública*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) formato da URL da imagem públicaformat for public image URL
TachadoStrikethrough ~~text~~ some ~~questoins~~ questions need to be asked formato de tachado
Negrito e itálicoBold and italics ***text**_ How can I create a _*_QnA Maker_** bot? formato para negrito e itálico
URL em negrito para o linkBold URL for link [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? formato para URL em negrito
URL de itálico para o linkItalics URL for link [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? formato para URL de itálico
Símbolos de redução de escapeEscape markdown symbols \*text\* How do I create a bot with \*QnA Maker\*? Formato para símbolos de redução de escape.
Lista ordenadaOrdered list \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
O exemplo anterior usa a numeração automática incorporada à redução.The preceding example uses automatic numbering built into markdown.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
O exemplo anterior usa a numeração explícita.The preceding example uses explicit numbering.
formato da lista ordenada
Lista não ordenadaUnordered list \n * item1 \n * item2
ouor
\n - item1 \n - item2
This is an unordered list: \n * List item 1 \n * List item 2 formato da lista não ordenada
Listas aninhadasNested lists \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

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

Você pode aninhar listas ordenadas e não ordenadas juntas.You can nest ordered and unordered lists together. A guia, \t , indica o nível de recuo do elemento filho.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
formato da lista não ordenada aninhada
formato da lista ordenada aninhada

* QnA Maker não processa a imagem de forma alguma.*QnA Maker doesn't process the image in any way. É a função do aplicativo cliente para renderizar a imagem.It is the client application's role to render the image.

Se você quiser adicionar conteúdo usando atualizar/substituir APIs da base de dados de conhecimento e o conteúdo/arquivo contiver marcas HTML, você poderá preservar o HTML em seu arquivo, garantindo que a abertura e o fechamento das marcas sejam convertidos no formato codificado.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.

Preservar HTMLPreserve HTML Representação na solicitação de APIRepresentation in the API request Representação em KBRepresentation in KB
SimYes &lt; br & gt;&lt;br&gt; <br><br>
SimYes &lt; H3 & gt; header & lt;/H3 & gt;&lt;h3&gt;header&lt;/h3&gt; <>/H3 de cabeçalho H3 <><h3>header</h3>

Além disso, CR LF (\r\n) são convertidas em \n no KB.Additionally, CR LF(\r\n) are converted to \n in the KB. A LF (\n) é mantida como está.LF(\n) is kept as is. Se você quiser escapar qualquer sequência de escape como um \t ou \n, poderá usar a barra invertida, por exemplo: ' \ \ r \ \ n ' e ' \ \ T'If you want to escape any escape sequence like a \t or \n you can use backslash, for example: '\\r\\n' and '\\t'

Próximas etapasNext steps

Examine os formatos de arquivode teste de lote.Review batch testing file formats.