마크다운 치트시트: 21가지 마크다운 문법 정리를 한 페이지에
마크다운 치트시트는 각 markdown 요소와 정확한 문법을 한 페이지에서 바로 찾아볼 수 있는 요약표로, 전체 문서를 뒤지지 않고도 문서 서식을 지정할 수 있습니다. 이 페이지는 21가지 요소 전체를 두 개의 표로 정리했습니다. 하나는 John Gruber가 2004년 원본 명세에서 정의한 기본 요소 10가지이고, 다른 하나는 CommonMark(2014년)와 GitHub Flavored Markdown(2017년) 같은 후속 플레이버가 추가한 확장 요소 11가지입니다. 이 페이지의 모든 문법 예시는 온라인 markdown 에디터에서도 그대로 동작하며, 입력하는 즉시 라이브 미리보기로 렌더링 결과를 확인할 수 있습니다.
기본 문법
기본 문법은 2004년 원본 markdown 설계에 포함된 10가지 요소로, 모든 markdown 앱에서 동일하게 렌더링됩니다. 이 10가지 요소만으로 일상적인 글쓰기의 대부분을 처리할 수 있습니다. 제목과 목록으로 구조를 잡고, 굵게와 기울임으로 강조하며, 링크와 이미지로 참조를 표시합니다. 이 표의 요소만 사용한 문서는 GitHub, Obsidian, Reddit, Discord는 물론 2004년 이후에 만들어진 어떤 에디터에서도 올바르게 표시됩니다.
| 요소 | Syntax | 렌더링 결과 |
|---|---|---|
| 제목 | # H1 / ## H2 / ### H3 | 레벨 1부터 6까지의 섹션 제목이며 # 하나가 한 레벨에 해당합니다 |
| 굵게 | **strong words** | 강조할 문구 |
| 기울임 | *slanted words* | 기울어진 문구 |
| 인용문 | > quoted line | 왼쪽 테두리가 있는 들여쓰기된 인용 블록 |
| 순서 있는 목록 | 1. Step one 2. Step two | 번호 목록이며 번호가 순서대로 표시됩니다 |
| 순서 없는 목록 | - First point - Second point | 글머리 기호 목록이며 *와 +도 마커로 사용할 수 있습니다 |
| 코드 | `inline code` | 고정폭 상자 안에 표시되는 인라인 코드 |
| 수평선 | --- | 섹션 사이를 나누는 전체 폭 구분선 |
| 링크 | [anchor text](https://example.com) | "anchor text"로 표시되는 클릭 가능한 하이퍼링크 |
| 이미지 |  | 접근성을 위한 대체 텍스트가 포함된 삽입 이미지 |
제목 기호는 마지막 # 뒤에 공백이 있어야 하고, 수평선 위에는 빈 줄이 있어야 합니다. 기본 문법 렌더링 오류의 대부분은 이 두 가지 때문에 발생합니다.
확장 문법
확장 문법은 2004년 원본 명세에 없던 11가지 요소를 추가한 것으로, 지원 여부는 앱이 구현한 markdown 플레이버에 따라 달라집니다. 표, 펜스 코드 블록, 작업 목록은 GitHub Flavored Markdown과 함께 등장했으며, GitHub는 2017년에 이를 정식 명세로 공식화했습니다. 각주, 정의 목록, 하이라이트는 다른 플레이버에서 나온 것으로, 지원하는 앱이 더 적습니다.
| 요소 | Syntax | 렌더링 결과 |
|---|---|---|
| 표 | | Name | Role | | --- | --- | | Ada | Engineer | | 머리글 행과 정렬된 열이 있는 격자형 표 |
| 펜스 코드 블록 | ```json { "id": 1 } ``` | 여러 줄 코드 상자이며 구문 강조를 지정할 수 있습니다 |
| 각주 | A claim.[^1] [^1]: The source. | 번호가 붙은 참조와 페이지 하단의 주석 |
| 제목 ID | ## Pricing {#pricing} | 직접 링크용 사용자 지정 앵커가 있는 제목 |
| 정의 목록 | Term : Meaning of the term | 용어 아래에 들여쓰기된 정의가 표시됩니다 |
| 취소선 | ~~old figure~~ | |
| 작업 목록 | - [x] Ship the draft - [ ] Review edits | 체크된 상자와 체크되지 않은 상자가 있는 체크리스트 |
| 이모지 숏코드 | :tada: | 해당하는 이모지 문자, 🎉 |
| 하이라이트 | ==key phrase== | 색상 배경 위에 표시되는 문구 |
| 아래 첨자 | H~2~O | H₂O |
| 위 첨자 | x^2^ | x² |
지원 범위는 앱마다 다릅니다. GitHub는 표, 펜스 코드 블록, 작업 목록, 취소선, 각주, 이모지 숏코드를 렌더링하지만 하이라이트, 아래 첨자, 위 첨자는 무시합니다. Obsidian은 표, 각주, 작업 목록, 취소선, 하이라이트를 지원합니다. Discord는 굵게, 기울임, 취소선, 코드 블록은 처리하지만 표와 각주는 지원하지 않습니다. 대상 플랫폼을 알 수 없다면 기본 문법 10가지가 안전한 선택입니다.
이 치트시트 사용 방법
왼쪽 열에서 요소를 찾고, 가운데 열의 문법을 복사한 뒤, 자리 표시자 텍스트를 원하는 내용으로 바꾸면 됩니다. 렌더링 결과 열에서 출력 모양을 미리 확인할 수 있으므로, 복사하기 전에 의도한 요소가 맞는지 판단할 수 있습니다. 확장 문법 표의 요소라면 먼저 지원 현황 안내를 확인해야 합니다. GitHub에서는 잘 보이는 각주도 Discord에서는 사라집니다.
문법을 확인하는 가장 빠른 방법은 온라인 markdown 에디터에 붙여넣는 것입니다. 라이브 미리보기가 각 요소를 몇 밀리초 만에 렌더링하기 때문에, 깨진 표나 닫히지 않은 ** 마커가 즉시 드러납니다. markdown을 매일 쓰는 사람이라면 기본 문법 표는 일주일 안에 자연스럽게 외우게 됩니다. 곁에 두고 볼 가치가 있는 것은 오히려 확장 문법 표입니다.
다운로드와 인쇄
이 마크다운 요약표는 A4 한 장에 들어가며 .md 파일로 제공되므로, 노트 앱에 보관하거나 인쇄해서 책상에 둘 수 있습니다. 다운로드한 파일 자체가 유효한 markdown이며, GFM 표를 지원하는 앱이라면 두 표 모두 올바르게 렌더링됩니다. 에디터에서 열든, Obsidian에서 열든, GitHub 저장소에서 열든 서식이 그대로 유지됩니다.
자주 묻는 질문
기본 문법과 확장 문법의 차이는 무엇입니까?
기본 문법은 2004년 원본 명세에 포함된 10가지 요소를 말하고, 확장 문법은 후속 플레이버가 추가한 11가지 요소를 말합니다. 기본 문법은 모든 markdown 앱이 지원합니다. 확장 문법은 플레이버에 따라 달라집니다. CommonMark는 2014년에 핵심 동작을 표준화했고, GFM은 2017년 명세에서 표, 작업 목록, 취소선을 추가했습니다.
모든 markdown 앱이 확장 문법을 지원합니까?
아니요. 확장 문법 지원은 앱마다 다르며, 11가지 확장 요소를 모두 렌더링하는 앱은 하나도 없습니다. GitHub는 하이라이트와 아래 첨자를 건너뛰고, Discord는 표와 각주를 건너뛰며, 셋 중에서는 Obsidian이 가장 넓은 범위를 지원합니다. 여러 플랫폼에 배포할 문서라면 기본 문법과 GFM 표 범위 안에서 작성하는 것이 안전합니다.
markdown은 배우기 어렵습니까?
아니요. markdown의 요소는 총 21가지뿐이며, 대부분의 문서는 기본 10가지로 충분합니다. 제목의 #, 굵게의 **, 목록의 -만으로 실제 사용의 대부분을 해결할 수 있습니다. 라이브 미리보기 에디터에서는 실수가 바로 눈에 보이기 때문에, 대부분의 사람이 한 번의 연습만으로 자연스러운 markdown을 쓸 수 있게 됩니다.