Compartilhar via


Formato Markdown compatível com o texto de resposta

A resposta a perguntas personalizadas armazena o texto da resposta como markdown. Existem várias variantes de markdown. Para ter certeza de que o texto de resposta será retornado e exibido corretamente, use esta referência.

Use o tutorial CommonMark para validar seu Markdown. O tutorial tem um recurso Experimentar para validação rápida de copiar/colar.

Quando usar edição de rich text ou 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.

Markdown é uma ferramenta melhor quando você precisa gerar o conteúdo automaticamente para criar projetos que serão importados como parte de um pipeline de CI/CD ou para testes em lotes.

Formato de markdown compatível

Veja a seguir a lista de formatos de markdown que podem ser usados no texto de resposta.

Finalidade Formatar Exemplo de markdown
Uma nova linha entre duas frases. \n\n How can I create a bot with \n\n custom question answering?
Cabeçalhos de H1 a H6, o número de # denota o cabeçalho. 1 # é o 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
Itálico *text* How do I create a bot with *custom question answering*?
Forte (negrito) **text** How do I create a bot with **custom question answering***?
URL do link [text](https://www.my.com) How do I create a bot with [custom question answering](https://language.cognitive.azure.com/)?
*URL de imagem pública ![text](https://www.my.com/image.png) How can I create a bot with ![custom question answering](path-to-your-image.png)
Tachado ~~text~~ some ~~questions~~ questions need to be asked
Negrito e itálico ***text*** How can I create a ***custom question answering**** bot?
URL do link em negrito [**text**](https://www.my.com) How do I create a bot with [**custom question answering**](https://language.cognitive.azure.com/)?
URL do link em itálico [*text*](https://www.my.com) How do I create a bot with [*custom question answering*](https://language.cognitive.azure.com/)?
Símbolos de markdown de escape \*text\* How do I create a bot with \*custom question answering*\*?
Lista ordenada \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 ao 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.
Lista não ordenada \n * item1 \n * item2
ou
\n - item1 \n - item2
This is an unordered list: \n * List item 1 \n * List item 2
Listas aninhadas \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

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

É possível aninhar listas ordenadas e não ordenadas. A guia, \t, indica o nível de recuo do elemento filho.
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
  • As respostas às perguntas personalizadas não processam a imagem de forma alguma. Renderizar a imagem é função do aplicativo cliente.

Se você quiser adicionar conteúdo usando as APIs do projeto de atualização/substituição e conteúdo/arquivo que contém tags html, preserve o HTML em seu arquivo garantindo que a abertura e o fechamento das tags sejam convertidos no formato codificado.

Preservar HTML Representação na solicitação de API Representação na base de dados de conhecimento
Sim < br> <br>
Sim < h3> cabeçalho <h3>header</h3>

Além disso, CR LF(\r\n) são convertidos em \n na base de dados de conhecimento. LF(\n) é mantido como está. Para escapar uma sequência de escape como \t ou \n, use a barra invertida, por exemplo: '\\r\\n' and '\\t'

Próximas etapas