QnA Maker 응답 텍스트에서 지원되는 Markdown 형식
QnA Maker는 응답 텍스트를 markdown으로 저장합니다. Markdown에는 여러 버전이 있습니다. 응답 텍스트가 반환되고 올바르게 표시되는지 확인하려면 이 참조를 사용합니다.
CommonMark 자습서를 사용하여 Markdown의 유효성을 검사합니다. 이 자습서에는 빠른 복사/붙여넣기 유효성 검사를 위한 Try it 기능이 있습니다.
서식 있는 텍스트 편집 및 markdown 사용 시기
답변의 서식 있는 텍스트 편집을 사용하면 작성자로서 서식 도구 모음을 사용하여 텍스트를 신속하게 선택하고 형식을 지정할 수 있습니다.
Markdown은 CI/CD 파이프라인의 일부로 가져오거나 일괄 테스트를 위해 가져올 기술 자료 만들기 위해 콘텐츠를 자동으로 생성해야 하는 경우 더 나은 도구입니다.
지원되는 Markdown 형식
다음은 QnA Maker의 대답 텍스트에서 사용할 수 있는 Markdown 형식 목록입니다.
목적 | 형식 | 예제 Markdown | 렌더링 채팅 봇에 표시된 대로 |
---|---|---|---|
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.learn.microsoft.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 앞의 예제에서는 markdown에 기본 제공된 자동 번호 매기기를 사용합니다. This is an ordered list: \n 1. List item 1 \n 2. List item 2 앞의 예제에서는 명시적 번호 매기기를 사용합니다. |
|
정렬되지 않은 목록 | \n * item1 \n * item2 또는 \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> | <br> |
예 | < h3> header | <h3>헤더</h3> |
또한 CR LF(\r\n)는 KB에서 \n으로 변환됩니다. LF(\n)는 그대로 유지됩니다. \t 또는 \n 등의 이스케이프 시퀀스를 이스케이프하려면 백슬래시를 사용할 수 있습니다(예: '\\r\\n' 및 '\\t').
다음 단계
일괄 처리 테스트 파일 형식을 검토합니다.