Im Antworttext von QnA Maker unterstütztes Markdown-Format

QnA Maker speichert den Antworttext im Markdown-Format. Es gibt viele Varianten des Markdown-Formats. Um sicherzustellen, dass der Antworttext ordnungsgemäß zurückgegeben und angezeigt wird, verwenden Sie diese Referenz.

Sie können Ihren Markdowncode anhand des Tutorials CommonMark überprüfen. Das Tutorial verfügt über eine Funktion Ausprobieren für die schnelle Überprüfung per Kopieren und Einfügen.

Vergleich der Anwendungsfälle für Rich-Text-Bearbeitung und Markdown

Mit der Rich-Text-Bearbeitung von Antworten können Sie als Autor die Formatierungssymbolleiste verwenden, um Text schnell auszuwählen und zu formatieren.

Markdown eignet sich besser, wenn Sie Inhalte automatisch generieren müssen, um Wissensdatenbanken zu erstellen, die im Rahmen einer CI/CD-Pipeline oder für Batchtests importiert werden.

Unterstütztes Markdown-Format

Im Folgenden finden Sie eine Liste der Markdown-Formate, die Sie im Antworttext von QnA Maker verwenden können.

Zweck	Format	Beispielmarkdown	Darstellung wie im Chatbot angezeigt
Eine neue Zeile zwischen zwei Sätzen.	\n\n	How can I create a bot with \n\n QnA Maker?
Header von h1 bis h6, die Anzahl der # gibt den Header an. 1 # ist 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
Kursiv	*text*	How do I create a bot with *QnA Maker*?
Strong (fett)	**text**	How do I create a bot with **QnA Maker**?
URL für einen Link	[text](https://www.my.com)	How do I create a bot with [QnA Maker](https://www.qnamaker.ai)?
*URL für öffentliches Bild		How can I create a bot with 
Durchgestrichen	~~text~~	some ~~questoins~~ questions need to be asked
Fett und kursiv	***text***	How can I create a ***QnA Maker*** bot?
Fette URL für einen Link	[**text**](https://www.my.com)	How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)?
Kursive URL für Link	[*text*](https://www.my.com)	How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)?
Markdown-Escapesymbole	\*text\*	How do I create a bot with \*QnA Maker\*?
Sortierte Liste	\n 1. item1 \n 1. item2	This is an ordered list: \n 1. List item 1 \n 1. List item 2 Im vorangehenden Beispiel wird die in Markdown integrierte automatische Nummerierung verwendet. This is an ordered list: \n 1. List item 1 \n 2. List item 2 Im vorangehenden Beispiel wird die explizite Nummerierung verwendet.
Unsortierte Liste	\n * item1 \n * item2 oder \n - item1 \n - item2	This is an unordered list: \n * List item 1 \n * List item 2
Geschachtelte Listen	\n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2 \n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2 Sie können sortierte und unsortierte Listen schachteln. Der Tabstopp \t gibt die Einzugsebene des untergeordneten Elements an.	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 verarbeitet das Bild nicht. Die Clientanwendung ist für das Rendern des Bilds zuständig.

Wenn Sie Inhalte mithilfe von Wissensdatenbank-APIs aktualisieren/ersetzen möchten und der Inhalt bzw. die Datei HTML-Tags enthält, können Sie HTML in Ihrer Datei beibehalten, indem Sie sicherstellen, dass die öffnenden und schließenden Tags in das codierte Format konvertiert werden.

Beibehalten von HTML	Darstellung in der API-Anforderung	Darstellung in Wissensdatenbank
Ja	< br>	<br>
Ja	< h3> header	<h3>header</h3>

Außerdem werden CR LF(\r\n) in der Wissensdatenbank in \n konvertiert. LF(\n) bleibt unverändert. Wenn Sie eine Escapesequenz wie \t oder \n als Escapezeichen verwenden möchten, können Sie einen Schrägstrich verwenden, zum Beispiel: \\r\\n und \\t.

Nächste Schritte

Informieren Sie sich über Dateiformate für Batchtests.