QnA Maker の回答テキストでサポートされるマークダウン形式

QnA Maker では、回答テキストがマークダウンとして格納されます。 マークダウンには、さまざまな決まりごとがあります。 回答テキストを確実に取得して正しく表示するために、このリファレンスをご利用ください。

Markdown の検証については、 CommonMark のチュートリアルをご覧ください。 チュートリアルには、コピー/貼り付けで簡単に検証するための [Try it](試してみる) 機能があります。

リッチテキスト編集を使用する場合と Markdown を使用する場合の比較

回答のリッチテキスト編集では、作成者は、書式設定ツールバーを使用して、テキストをすばやく選択し、書式設定することができます。

Markdown は、CI/CD パイプラインの一部として、またはバッチ テストのためにインポートされるナレッジ ベースを作成するために、コンテンツを自動生成する必要がある場合に適しています。

サポートされるマークダウン形式

QnA Maker の回答テキストで使用できるマークダウン形式の一覧を次に示します。

目的 Format マークダウンの例 表示
チャット ボットの表示
2 つの文の間の改行。 \n\n How can I create a bot with \n\n QnA Maker? format new line between two sentences
h1 から h6 までのヘッダー。# の数はどのヘッダーかを表します。 1 # は 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
format with markdown headers
format with markdown headers H1 to H5
斜体 *text* How do I create a bot with *QnA Maker*? format with italics
強調 (太字) **text** How do I create a bot with **QnA Maker**? format with strong marking for bold
リンクの URL [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? format for URL (hyperlink)
\* 公開画像の URL ![text](https://www.my.com/image.png) How can I create a bot with ![QnAMaker](https://review.learn.microsoft.com/azure/ai-services/qnamaker/media/qnamaker-how-to-key-management/qnamaker-resource-list.png) format for public image URL
取り消し線 ~~text~~ some ~~questoins~~ questions need to be asked format for strikethrough
太字と斜体 ***text*** How can I create a ***QnA Maker*** bot? format for bold and italics
リンクの太字の URL [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? format for bold URL
リンクの斜体の URL [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? format for italics URL
マークダウン記号のエスケープ \*text\* How do I create a bot with \*QnA Maker\*? Format for escape markdown symbols.
番号付きリスト \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
上の例では、マークダウンに組み込まれた自動番号付けを使用しています。
This is an ordered list: \n 1. List item 1 \n 2. List item 2
上の例では明示的な番号付けを使用しています。
format for ordered list
記号付きリスト \n * item1 \n * item2
or
\n - item1 \n - item2
This is an unordered list: \n * List item 1 \n * List item 2 format for unordered list
入れ子になったリスト \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

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

番号付きリストと記号付きリストを一緒に入れ子にすることができます。 タブ \t は、子要素のインデント レベルを示します。
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
format for nested unordered list
format for nested ordered list

\* QnA Maker ではどのような方法でも画像は処理されません。 画像をレンダリングするのはクライアント アプリケーションの役割です。

ナレッジベースの更新または置換 API を使用してコンテンツを追加する場合で、なおかつ、コンテンツまたはファイルに html タグが含まれている場合は、タグの開始と終了がエンコードされた形式に変換されるようにすることで、ファイル内の HTML を維持できます。

HTML の維持 API 要求での表記 KB での表記
はい
<br>
はい

header

<h3>header</h3>

さらに、CR LF (\r\n) は KB では \n に変換されます。 LF (\n) はそのまま維持されます。 \t や \n のようなエスケープ シーケンスをエスケープする場合は、円記号を使用できます。例: '\\r\\n' および '\\t'

次のステップ

バッチ テストのファイル形式について確認する