100% 프라이빗 — 모든 처리가 브라우저에서
마크다운 수평선 — 구분선 문법과 예제
하이픈, 별표, 언더스코어 세 개로 마크다운 수평선이 만들어집니다. 각 형식을 클릭해 구분선이 실시간으로 그려지는 것을 보고, 필요한 것을 복사하세요.
MD Viewer 팀
Text above the divider
Text below the divider
마크다운 수평선 — 사양으로는 주제 구분선 — 은 문서의 섹션을 나누는 전체 폭의 구분선입니다. 하이픈, 별표, 언더스코어를 세 개 이상 자기 줄에 놓으면 만들어집니다. ---, ***, ___. 위의 놀이터에서 각 형식을 클릭하면 왼쪽에 소스, 오른취에 렌더링된 마크다운 수평선이 즉시 나타납니다.
구문은 단순해 보이지만 두 가지 디테일이 모두를 잡습니다. 첫째, 마크다운 수평선을 담는 줄 앞에는 빈 줄이 필요합니다. 없으면 텍스트 바로 아래의 ---가 그 텍스트를 제목으로 바꿔 버립니다. 둘째, 언더스코어 사이에는 공백을 넣을 수 없고, 하이픈과 별표는 넣을 수 있습니다. 놀이터의 '제목 모호성' 예제가 이 함정을 실시간으로 보여, README로 출고되기 전에 자기 파일에서 알아보게 됩니다.
모든 것은 브라우저에서 로컬로 동작합니다. 예제를 편집하고, 구분선 위아래에 자기 텍스트를 더하고, '마크다운 복사'로 작동하는 마크다운 수평선을 어디든 붙여넣으세요. 도구 아래에는 완전한 구문 표, 구분선을 깔끔하게 넣는 절차, Setext 제목 함정 설명, 수평선에 관한 자주 묻는 질문이 이어집니다.
마크다운 수평선 구문 참조
| 입력 | 렌더링 결과 |
|---|---|
| --- | 마크다운 수평선(주제 구분선) |
| *** | 별표로 만든 수평선 |
| ___ | 언더스코어로 만든 수평선 |
| - - - | 공백을 낀 하이픈도 구분선이 된다 |
| ---------- | 세 글자를 넘어도 같은 표시 |
| 제목 --- | 구분선이 아니라 H2 제목으로 렌더링(Setext) |
마크다운 수평선을 올바르게 넣는 법
- 1
위에 빈 줄 두기
빈 줄이 마커를 앞 문단에서 떼어 놓습니다. 없으면 텍스트 줄 아래의 ---가 마크다운 수평선을 긋는 대신 그 줄을 제목으로 재정의합니다.
- 2
마커 세 개 이상 입력
---, ***, ___ 중 하나를 골라 같은 문자를 세 번 이상 반복합니다. 길이와 무관하게 마크다운 수평선은 같게 렌더링되고, 대부분의 스타일 가이드는 정확히 세 글자로 정합니다.
- 3
아래에도 빈 줄 잇기
구분선 뒤의 빈 줄은 다음 문단이 붙는 것을 막고, 바로 뒤따르는 하이픈 목록을 모호함에 빠뜨리지 않게 합니다. 마크다운 수평선의 양쪽 빈 줄은 보험입니다.
- 4
미리보고 복사하기
위의 칩으로 세 가지 마커를 시험하고, '마크다운 복사'로 정확한 소스를 가져가세요. 붙여넣은 마크다운 수평선은 모든 CommonMark 플랫폼에서 렌더링됩니다.
Setext 함정: ---가 마크다운 수평선이 아닐 때
문단 아래에서 하이픈 줄은 의미가 완전히 바뀝니다. Setext 제목 밑줄이 되어 위의 텍스트를 H2로 승격시킵니다. 텍스트 바로 뒤의 ---는 큰 제목을 만들고, 텍스트-빈 줄----는 문단과 마크다운 수평선을 만듭니다. 수평선을 둘러싼 가장 흔한 혼란이 이것이고, '제목 모호성' 예제가 한 줄 차이로 두 결과를 보여줍니다.
같은 상호작용이 더 미묘한 실패도 설명합니다. 하이픈 목록 바로 아래의 ---는 렌더러에 따라 구분선을 목록에 붙일 수 있습니다. 양쪽의 빈 줄이 해법입니다. 마크다운 수평선이 시작되기 전에 주변 구성 요소를 모두 닫습니다. 구분선이 언젠가 이상하게 렌더링되면, 먼저 빠진 빈 줄을 의심하세요.
수평선이 빛나는 곳도 짚어 둡니다. 릴리스 노트는 버전마다 마크다운 수평선을 놓아 v2.4를 찾는 독자가 블록에서 블록으로 시각적으로 건너뛰게 합니다. 긴 가이드는 부록 앞에 하나를 놓고, 개인 메모는 하나의 파일에서 날짜나 주제를 나눕니다. 제목이 섹션을 알리고, 마크다운 수평선이 큰 흐름을 표시하고, 여백이 나머지를 담당하는 것 — 구조를 위한 구분선의 올바른 사용법입니다.
마크다운 수평선의 실수와 수정
제목 ---
제목 ---
빈 줄이 없으면 하이픈이 제목을 H2로 바꿉니다. 빈 줄을 넣으면 의도한 마크다운 수평선이 돌아옵니다.
_ _ _
___
공백을 낀 언더스코어는 구분선이 되지 않고, 심지어 텍스트를 강조할 수 있습니다. 언더스코어는 붙이고, 하이픈과 별표는 공백을 허용합니다.
하이픈 두 개 --
하이폰 세 개 ---
마크다운 수평선에는 마커 문자가 세 개 이상 필요합니다. 두 개는 문자 그대로 텍스트로 나타납니다.
구분선은 구조를 위한 것, 장식이 아닙니다
마크다운 수평선은 큰 섹션 경계 — 부록, 변경 이력의 구분, 주제 전환 — 를 알립니다. 모든 하위 섹션에 구분선을 두는 문서는 어수선해 보입니다. 먼저 제목을 쓰고, 마크다운 수평선은 정말 필요한 이음새를 위해 아껴 두세요.
구분선을 점검하는 리뷰 습관
풀 리퀘스트에서 구분선 변경을 리뷰할 때는 마커 바로 위의 줄을 먼저 보세요. 그 줄이 비어 있지 않다면 이 변경은 구분선이 아니라 제목 구조를 바꾼 것입니다. 이 간단한 확인 절차가 문서의 개요 전체를 뒤집는 사고를 막아 줍니다.
문서를 오래 운영한다면 구분선의 수도 함께 관리하세요. 섹션이 늘어날 때마다 구분선을 추가하기보다 제목 수준으로 정리하고, 정말 큰 전환점에만 구분선을 남겨 두면 문서가 커져도 목차가 선명하게 유지됩니다. 구분선은 적을수록 더 강하게 읽힙니다.
구분선의 역사는 인쇄 시대까지 거슬러 올라갑니다. 오래된 책의 장(章)이 바뀌는 지점에 그어진 선들은 오늘날의 마크다운 수평선과 정확히 같은 일을 합니다. 큰 흐름의 전환을 눈에 보여 주는 것. 그 전통을 이어받은 만큼, 문서에서도 정말 큰 전환에만 선을 그어 주면 도구 본연의 효과가 살아납니다.
구분선을 다루는 마지막 지혜는 절제입니다. 문서가 길어질수록 독자는 시각적 표지를 찾는데, 구분선이 흔하면 표지로서의 기능을 잃습니다. 정말 큰 장이 바뀌는 곳, 주제가 완전히 전환되는 곳에만 선을 남기면 남은 소수의 선이 문서의 이정표처럼 선명하게 읽힙니다.
실무에서는 구분선을 넣기 전에 한 번 더 자문해 보세요. 이 선 없이는 두 섹션이 하나로 읽히는가. 그렇다면 선이 필요한 자리이고, 그렇지 않다면 제목과 여백이 이미 일을 하고 있다는 뜻입니다. 이 하나의 질문이 문서 전체의 위계를 일관되게 유지해 줍니다.
자주 묻는 질문
출처 및 사양 인용
“A line consisting of optionally up to three spaces of indentation, followed by a sequence of three or more matching -, _, or * characters, each followed optionally by any number of spaces or tabs, forms a thematic break.”