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').
다음 단계
일괄 처리 테스트 파일 형식을 검토합니다.