Formato Markdown supportato nel testo della risposta di QnA Maker
QnA Maker archivia il testo della risposta come markdown. Ci sono molti sapori di markdown. Per assicurarsi che il testo della risposta venga restituito e visualizzato correttamente, usare questo riferimento.
Usare l'esercitazione CommonMark per convalidare il codice Markdown. L'esercitazione contiene la funzionalità Prova per la convalida veloce copia/incolla.
Quando usare la modifica rtf invece del markdown
La modifica rtf delle risposte ti consente, come autore, di utilizzare una barra degli strumenti di formattazione per selezionare e formattare rapidamente il testo.
Markdown è uno strumento migliore quando è necessario generare automaticamente il contenuto per creare knowledge base da importare come parte di una pipeline CI/CD o per i test batch.
Formato markdown supportato
Di seguito è riportato l'elenco dei formati markdown che è possibile usare nel testo della risposta di QnA Maker.
Scopo | Formato | Markdown di esempio | Rendering come visualizzato in Chat bot |
---|---|---|---|
Nuova riga tra 2 frasi. | \n\n |
How can I create a bot with \n\n QnA Maker? |
|
Le intestazioni da h1 a h6, il numero di # indica l'intestazione. 1 # è l'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 |
|
Corsivo | *text* |
How do I create a bot with *QnA Maker*? |
|
Forte (grassetto) | **text** |
How do I create a bot with **QnA Maker**? |
|
URL per il collegamento | [text](https://www.my.com) |
How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? |
|
*URL per l'immagine pubblica | ![text](https://www.my.com/image.png) |
How can I create a bot with ![QnAMaker](https://review.video2.skills-academy.com/azure/ai-services/qnamaker/media/qnamaker-how-to-key-management/qnamaker-resource-list.png) |
|
barrato | ~~text~~ |
some ~~questoins~~ questions need to be asked |
|
Grassetto e corsivo | ***text*** |
How can I create a ***QnA Maker*** bot? |
|
URL in grassetto per il collegamento | [**text**](https://www.my.com) |
How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? |
|
URL corsivo per il collegamento | [*text*](https://www.my.com) |
How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? |
|
Simboli markdown di escape | \*text\* |
How do I create a bot with \*QnA Maker\*? |
|
Elenco ordinato | \n 1. item1 \n 1. item2 |
This is an ordered list: \n 1. List item 1 \n 1. List item 2 Nell'esempio precedente viene usata la numerazione automatica incorporata in markdown. This is an ordered list: \n 1. List item 1 \n 2. List item 2 Nell'esempio precedente viene utilizzata la numerazione esplicita. |
|
Elenco non ordinato | \n * item1 \n * item2 or \n - item1 \n - item2 |
This is an unordered list: \n * List item 1 \n * List item 2 |
|
Elenchi annidati | \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2 \n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2 È possibile annidare elenchi ordinati e non ordinati insieme. La scheda , \t , indica il livello di rientro dell'elemento figlio. |
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 non elabora l'immagine in alcun modo. È il ruolo dell'applicazione client per eseguire il rendering dell'immagine.
Se si vuole aggiungere contenuto usando le API della Knowledge Base update/replace e il contenuto/file contiene tag HTML, è possibile mantenere il codice HTML nel file assicurandosi che l'apertura e la chiusura dei tag vengano convertiti nel formato codificato.
Mantieni HTML | Rappresentazione nella richiesta API | Rappresentazione in KB |
---|---|---|
Sì | < br> | <Br> |
Sì | < h3> intestazione | <intestazione< h3>/h3> |
Inoltre, CR LF(\r\n) viene convertito in \n nella KNOWLEDGE Base. LF(\n) viene mantenuto così come è. Se si desidera eseguire l'escape di qualsiasi sequenza di escape come \t o \n, è possibile usare la barra rovesciata, ad esempio '\\r\\n' e '\\t'
Passaggi successivi
Esaminare i formati di file di test batch.