Markdown 수평선: 구분선 문법과 자주 발생하는 문제 해결

Markdown에 수평선을 추가하려면 하이픈 세 개를 한 줄에 따로 쓰고 그 위아래에 빈 줄을 넣으세요.

첫 번째 섹션의 끝입니다.

---

다음 섹션의 시작입니다.

두 문단 사이에 구분선이 나타납니다. Markdown에서는 주제 구분선이라고 하며 HTML은 <hr>로 표현합니다. 예제를 Markdown 뷰어에 붙여 넣어 렌더링된 문서를 확인하세요.

구분선을 쓰는 세 가지 방법

다음 형식은 모두 주제 구분선을 만듭니다.

Markdown 원문	결과
---	수평 구분선
***	수평 구분선
___	수평 구분선
* * *	수평 구분선

같은 하이픈, 별표 또는 밑줄을 세 개 이상 사용하세요. 기호 사이에는 공백을 넣을 수 있습니다. 기호 종류를 섞거나, 같은 줄에 다른 텍스트를 쓰거나, 기호를 두 개만 쓰면 구분선이 만들어지지 않습니다. 이는 CommonMark 주제 구분선 명세의 문법 규칙입니다.

하이픈 수는 선의 표시 너비를 조절하지 않습니다. 20개와 세 개 모두 같은 HTML 요소를 만들며 외형은 대상 환경의 스타일이 결정합니다.

수평선이 제목으로 바뀌는 이유는 무엇인가요?

다음 원문은 “업데이트 내역” 아래에 구분선을 넣는 문법이 아닙니다.

업데이트 내역
---

이 코드는 2단계 제목을 만듭니다. 문단 바로 아래의 하이픈은 Setext 제목이 될 수 있으며 이 해석이 수평선보다 우선합니다. 둘 사이에 빈 줄을 넣으세요.

업데이트 내역

---

문서 섹션에는 명시적인 제목을 쓰는 편이 더 명확한 경우가 많습니다.

## 업데이트 내역

가져오기 과정에서 이제 CSV 파일을 지원합니다.

섹션의 이름은 Markdown 제목으로 표시하세요. 편지와 부록을 나누는 경우처럼 내용 전환 자체가 중요할 때는 수평선을 사용하세요.

구분선이 일반 텍스트로 표시되는 이유는 무엇인가요?

구분선 주변의 원문을 확인하세요.

증상	가능한 원인	해결 방법
코드 블록 안에 ---가 보임	독립된 블록 앞에 공백 네 개가 있거나 코드 울타리가 닫히지 않음	들여쓰기를 제거하거나 코드 울타리를 닫기
--가 그대로 보임	하이픈이 두 개뿐임	세 개 이상 사용하기
기호 옆에 글자가 보임	같은 줄에 다른 텍스트가 있음	기호를 한 줄에 따로 쓰기
문장 안에 ---가 보임	기호를 백틱으로 감쌈	구분선을 만들려면 백틱 제거하기
이전 문단이 제목이 됨	--- 위에 빈 줄이 없음	빈 줄 넣기

문서 최상위에서는 주제 구분선 앞에 최대 세 개의 공백을 넣을 수 있습니다. 목록 안에서는 들여쓰기가 내용이 속한 항목도 결정하므로 공백을 모두 지우기보다는 주변 목록 구조를 확인하세요.

수평선과 줄바꿈은 다릅니다

구분선은 섹션을 나눕니다. 뒤의 글자를 단순히 다음 줄로 보내는 기능이 아닙니다.

주소에는 명시적 줄바꿈을 사용하세요.

마켓 스트리트 120번지\
캘리포니아주 샌프란시스코

새 문단을 만들려면 빈 줄을 남기세요. 섹션을 구분하려면 ---를 별도 줄에 쓰세요. Markdown 줄바꿈 안내는 줄 끝 공백, 백슬래시, GitHub 파일과 댓글의 서로 다른 줄바꿈 동작을 설명합니다.

인용문 안에 구분선 넣기

구분선과 빈 줄을 포함한 모든 줄에서 > 접두사를 유지하세요.

> 원래 제안입니다.
>
> ---
>
> 검토자가 추가한 배경 정보입니다.

구분선은 인용문 안에 남습니다. 구분선에서 >를 빼면 인용문이 끝나고 선이 바깥 문서로 옮겨갈 수 있습니다. 여러 문단과 중첩 인용은 인용문 예제를 참고하세요.

표의 구분 행은 수평선이 아닙니다

다음 줄은 표에 속합니다.

| 형식 | 편집 가능 |
| --- | :---: |
| Markdown | 예 |

파이프와 선택적인 콜론은 열을 설명합니다. 페이지 전체를 가로지르는 구분선을 넣지는 않습니다. Markdown 표 생성기로 표를 만들거나, 데이터가 이미 스프레드시트에 있다면 CSV를 Markdown으로 변환하는 도구를 사용하세요.

수평선과 내보낸 문서

주제 구분선은 페이지 나누기 명령이 아닙니다. PDF나 Word 내보내기 도구는 레이아웃과 페이지 나누기 규칙에 따라 페이지 끝을 정합니다. 하이픈을 더 넣는다고 다음 섹션이 새 페이지에서 시작하지는 않습니다.

CSS를 직접 관리하는 웹페이지라면 생성된 <hr>를 사이트 스타일시트로 꾸밀 수 있습니다. 호스팅형 Markdown 서비스는 사용자 지정 CSS를 허용하지 않을 수 있습니다. 특히 인쇄 후에도 구분선이 의미를 전달해야 한다면 최종 게시 위치나 내보낸 문서를 확인하세요.

자주 묻는 질문

수평선 앞뒤에 빈 줄이 필요한가요?

CommonMark가 모든 문맥에서 빈 줄을 요구하지는 않지만, 빈 줄을 사용하면 ---가 제목으로 해석되는 흔한 모호함을 피하고 원문을 읽기 쉽게 만들 수 있습니다.

HTML hr 태그를 사용할 수 있나요?

원시 HTML을 허용하는 렌더러에서는 <hr>가 작동합니다. Markdown 문서에는 ---가 더 적합합니다. MD File Viewer 편집기는 사용자 HTML 태그를 제거하지만 Markdown 구분선 문법은 정상적으로 렌더링합니다.

구분선을 만들지 않고 하이픈 세 개를 표시하려면 어떻게 하나요?

문법 예제에는 인라인 코드 `---`를 쓰세요. 별도 줄에 일반 텍스트로 표시하려면 첫 하이픈을 이스케이프하여 \---로 쓰세요.

다른 자주 사용하는 서식은 Markdown 치트 시트에서 찾아볼 수 있습니다.