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? |
|
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 |
|
斜体 | *text* |
How do I create a bot with *QnA Maker*? |
|
強調 (太字) | **text** |
How do I create a bot with **QnA Maker**? |
|
リンクの URL | [text](https://www.my.com) |
How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? |
|
\* 公開画像の URL | ![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) |
|
取り消し線 | ~~text~~ |
some ~~questoins~~ questions need to be asked |
|
太字と斜体 | ***text*** |
How can I create a ***QnA Maker*** bot? |
|
リンクの太字の URL | [**text**](https://www.my.com) |
How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? |
|
リンクの斜体の URL | [*text*](https://www.my.com) |
How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? |
|
マークダウン記号のエスケープ | \*text\* |
How do I create a bot with \*QnA Maker\*? |
|
番号付きリスト | \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 上の例では明示的な番号付けを使用しています。 |
|
記号付きリスト | \n * item1 \n * item2 or \n - item1 \n - item2 |
This is an unordered list: \n * List item 1 \n * List item 2 |
|
入れ子になったリスト | \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 |
\* 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'
次のステップ
バッチ テストのファイル形式について確認する