다음을 통해 공유


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
markdown 헤더가 있는 형식
Markdown 헤더 H1부터 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 형식(하이퍼링크)
* 공용 이미지에 대한 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) 공용 이미지 URL의 형식
취소선 ~~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의 형식
링크에 대한 기울어지게 하는 URL [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? 기울탈릭 URL에 대한 형식
이스케이프 마크다운 기호 \*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').

다음 단계

일괄 처리 테스트 파일 형식을 검토합니다.