다음을 통해 공유


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? 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
앞의 예제에서는 markdown에 기본 제공된 자동 번호 매기기를 사용합니다.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
앞의 예제에서는 명시적 번호 매기기를 사용합니다.
format for ordered list
정렬되지 않은 목록 \n * item1 \n * item2
또는
\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> <Br>
< h3> header <h3>헤더</h3>

또한 CR LF(\r\n)는 KB에서 \n으로 변환됩니다. LF(\n)는 그대로 유지됩니다. \t 또는 \n 등의 이스케이프 시퀀스를 이스케이프하려면 백슬래시를 사용할 수 있습니다(예: '\\r\\n' 및 '\\t').

다음 단계

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