Markdown 인용 블록: 인용문, 여러 문단, 목록
>로 Markdown 인용문을 작성하고, 인용 블록을 중첩하고, 여러 문단을 인용하세요. Word 내보내기 전에 GitHub 알림과 범용 문법의 차이도 확인합니다.
Markdown 인용 블록은 > 뒤에 공백 하나를 넣어 시작합니다. 인용하는 각 줄의 시작에 마커를 넣으면 소스를 읽고 편집하기 쉬워집니다.
> 수정된 설치 가이드를 검토할 준비가 되었습니다.
결과는 코드 블록이 아니라 인용된 문단입니다. 테두리, 들여쓰기, 색상은 페이지나 문서 테마에 따라 달라집니다. 인용문은 일반 Markdown 텍스트이므로 강조, 링크, 목록 등 문서 구조를 포함할 수 있습니다.
Markdown 뷰어에서 예제를 시험해 보고, 편집 가능한 검토용 사본이 필요하면 Markdown을 Word로 변환하는 도구로 문서를 내보내세요.
소스 여러 줄에 걸친 문단 인용하기
긴 인용문에서는 마커를 반복합니다.
> 수정된 설치 가이드를 검토할 준비가 되었습니다.
> 릴리스를 승인하기 전에 사전 요구 사항을 확인하세요.
이 사이트의 미리보기에서는 이 두 소스 줄이 하나의 문단을 이룹니다. 소스의 줄바꿈이 표시상의 줄바꿈을 반드시 강제하지는 않습니다. 문구를 두 줄로 유지해야 한다면 명시적인 줄바꿈을 추가하세요.
> 문서 검토\
> 릴리스 관리자에게 배정됨
백슬래시는 줄바꿈 문자 앞에 놓고, 다음 줄도 인용 마커로 시작합니다. 강제 줄바꿈과 문단 나누기의 차이는 Markdown 줄바꿈을 참고하세요.
하나의 인용문에 여러 문단 포함하기
문단 사이의 원래 비어 있을 줄에도 인용 마커를 넣습니다.
> 첫 번째 초안은 설치 과정을 설명합니다.
>
> 두 번째 초안은 문제 해결 단계와 예제를 추가합니다.
이렇게 하면 두 문단이 포함된 하나의 인용 블록이 만들어집니다. 구분 줄에 >를 유지하면 의도한 묶음이 명확해지며, 특히 나중에 다른 사람이 내용을 편집할 때 도움이 됩니다.
자신의 본문을 다시 이어 쓰려면 빈 줄을 넣고 마커 없이 계속 작성합니다.
> 검토 의견에서 설치 절을 더 짧게 줄여 달라고 요청했습니다.
자세한 구성 설명은 부록으로 옮겼습니다.
빈 줄을 추가하지 않은 채 이어지는 줄에서 >만 제거하지 마세요. 일부 Markdown 파서는 이를 마커를 생략한 인용 문단의 연속 줄로 간주합니다. CommonMark 인용 블록 명세에서 이 동작을 설명합니다. 명시적인 마커와 분명한 빈 줄을 사용하면 공동 작업자가 유지 관리하기 쉽습니다.
강조, 링크, 출처 추가하기
인용 블록의 내용에는 일반 인라인 서식을 사용할 수 있습니다.
> **검토 의견:** 마이그레이션 단계에 실행 가능한 예제가 필요합니다.
> [릴리스 체크리스트](https://example.com/checklist)를 참고하세요.
>
> 2026년 9월 문서 검토에서 받은 피드백.
Markdown은 마지막 줄에 특별한 출처 인용 역할을 부여하지 않습니다. 인용 블록 안의 일반 문단 내용일 뿐입니다. 필요할 때 출처, 작성자, 링크를 포함하고, 다른 사람의 글을 재현하기 전에 사용 허가를 확인하세요.
인용 블록은 실제 따옴표를 자동으로 추가하지도 않습니다. 최종 문서에 따옴표가 필요하다면 직접 입력하세요. 자신의 문장 안에 짧은 인용문을 넣을 때는 별도의 블록 없이 일반 따옴표만으로 충분할 수도 있습니다.
인용문 중첩하기 또는 목록 포함하기
바깥 인용문 안에 다시 인용할 내용이 있으면 > 단계를 하나 더 추가합니다.
> 검토자는 이전 요청을 다음과 같이 요약했습니다.
>
> > 구성 파일의 완전한 예제를 추가하세요.
>
> 업데이트된 초안에는 이제 해당 예제가 포함되어 있습니다.
보고서에서는 중첩 단계를 얕게 유지하세요. 인용문이 깊게 중첩되면 텍스트에 사용 가능한 너비가 줄어 PDF와 Word 레이아웃을 읽기 어려워질 수 있습니다.
인용문 안의 목록에서도 모든 줄에 마커를 유지합니다.
> 검토에서 두 가지 변경 사항을 확인했습니다.
>
> - 필요한 권한을 설명합니다.
> - 문제 해결 절을 추가합니다.
반대 구조인 목록 안의 인용문은 목록 항목의 본문 아래에 맞춰 들여쓰기합니다.
- 문서 피드백
> 게시하기 전에 문제 해결 절을 추가하세요.
- 릴리스 체크리스트
인용문이 항목 밖에 나타나면 Markdown 들여쓰기 가이드의 예제와 들여쓰기를 비교하세요.
GitHub 알림은 대상 플랫폼의 지원이 필요합니다
GitHub는 다음 형식을 포함하여 인용 문법을 기반으로 한 특별한 알림을 지원합니다.
> [!NOTE]
> 구성을 변경하기 전에 백업하세요.
GitHub는 알림 참고 문서에 지원하는 유형을 설명합니다. 알림 색상과 아이콘은 플랫폼 기능이며, 모든 Markdown 인용문에 공통으로 있는 속성이 아닙니다.
이 사이트의 렌더러는 GitHub 알림 스타일을 추가하지 않습니다. 이 예제는 [!NOTE] 라벨이 보이는 인용 블록으로 남습니다. 여러 대상 플랫폼에서 깔끔하게 읽혀야 하는 문서라면 명시적인 굵은 라벨을 사용하세요.
> **참고:** 구성을 변경하기 전에 백업하세요.
이렇게 하면 특별한 알림 확장 없이도 의미를 이해할 수 있습니다. 경고, 검토 결정, 편집자 메모에도 같은 방식을 사용할 수 있습니다.
내보내기 전에 인용문 문제 해결하기
>가 그대로 보이면 예제가 백틱, 울타리 코드 블록 또는 들여쓰기 코드 블록 안에 있는지 확인하세요. 이런 문맥은 원래 소스 텍스트를 보여 주기 위한 것입니다. 마커 앞에 백슬래시를 놓아도 해당 마커가 이스케이프됩니다.
너무 많은 텍스트가 인용되면 인용 밖으로 돌아와야 하는 문단 앞에 빈 줄을 추가하세요. 중첩된 내용을 따라가기 어렵다면 중첩을 줄이고 출처를 일반 문단으로 추가합니다.
마지막으로 내보낸 DOCX를 열어 긴 인용문과 인용된 목록을 확인하세요. 브라우저의 왼쪽 테두리와 Word 문서의 문단 스타일은 다를 수 있습니다. 소스 서식 문제와 내보내기 스타일 문제를 구분해야 할 때는 Markdown을 HTML로 변환하는 도구로 중간 구조를 확인하세요.