마크다운 사용법: 제목·목록·표 만드는 기본 문법

마크다운은 서식을 표시하는 텍스트 문법입니다

마크다운은 글 앞뒤에 간단한 기호를 붙여 제목, 목록, 강조 등을 나타내는 방식입니다. 일반 텍스트로 저장해도 구조를 알아보기 쉽고, 지원하는 편집기에서는 읽기 좋은 화면으로 바꿔 보여줍니다. 블로그 원고, 프로젝트 안내, 개인 메모처럼 내용을 여러 곳으로 옮겨 쓰는 작업에 활용할 수 있습니다.

다만 마크다운 파일이 모든 프로그램에서 같은 모습으로 보이는 것은 아닙니다. 기본 문법에 표·체크리스트 등의 확장을 더한 편집기도 있고, 일부 기능만 지원하는 서비스도 있습니다. 글의 구조와 표현을 나누어 생각하고 실제 발행할 화면에서 확인하는 습관이 필요합니다. 파일 확장자를 바꾸는 것만으로 모든 서식이 자동 변환되는 것도 아닙니다.

제목은 글자 크기보다 내용의 계층을 나타냅니다

줄 맨 앞에 샵 기호와 공백을 넣으면 제목을 표시할 수 있습니다. 일반적으로 #은 가장 큰 제목, ##은 그 아래 제목, ###은 하위 제목에 사용합니다. 문서 제목 다음에 큰 절을 나누고, 그 절 안에서 필요한 경우에만 하위 제목을 추가하세요. 큰 글씨가 필요하다는 이유로 제목 단계를 건너뛰면 구조가 혼란스러워집니다.

# 주말 여행 준비

## 교통편 확인

### 기차를 이용할 때

예약한 날짜와 출발역을 확인합니다.

블로그가 제목 입력란을 따로 제공한다면 본문 첫 줄에 같은 제목을 다시 넣지 않아도 됩니다. 생활나침반도 페이지 제목은 별도로 표시하고 본문 절은 ##부터 구성합니다. 다른 편집기에서도 제목 입력란과 본문 미리보기를 함께 살펴보세요. 제목 기호 바로 뒤에 공백을 넣지 않으면 일반 글자로 남는 경우가 있습니다.

목록은 나열과 순서를 구분해서 쓰세요

준비물처럼 순서가 중요하지 않은 항목은 하이픈과 공백으로 표시합니다. 접수나 설치처럼 앞뒤 순서가 있는 일은 숫자와 마침표를 사용합니다. 목록 안에 서로 다른 목적의 내용을 길게 넣기보다 한 항목에 한 가지 행동을 담으면 읽기 쉽습니다. 복잡한 들여쓰기는 편집기마다 차이가 있으니 처음에는 한 단계 목록부터 익히세요.

- 신분증
- 예약 내역
- 충전기

1. 날짜를 선택합니다.
2. 내용을 확인합니다.
3. 접수 결과를 저장합니다.

위 예시에서 하이픈 목록은 준비물, 번호 목록은 진행 순서를 나타냅니다. 항목 사이에 설명 문단을 끼워 넣었을 때 목록이 끊기는지도 확인하세요. 빈 줄과 들여쓰기가 예상하지 못한 구분을 만들 수 있습니다. 실제 절차가 아닌 내용에 번호를 붙여 반드시 그 순서대로 해야 한다는 인상을 주지 않는 것도 중요합니다.

강조와 링크는 필요한 곳에만 사용합니다

중요한 단어 앞뒤에 별표 두 개를 붙이면 굵게 표시할 수 있습니다. 링크는 대괄호 안에 설명을 적고 이어지는 소괄호에 주소를 넣습니다. ‘여기를 클릭’보다 이동할 페이지의 이름을 적으면 독자가 목적지를 예상하기 쉽습니다. 문장 전체를 굵게 만들면 정작 중요한 조건이 눈에 들어오지 않을 수 있습니다.

**접수 마감일**을 먼저 확인하세요.
[GitHub 마크다운 안내](https://docs.github.com/en/get-started/writing-on-github)

링크를 붙인 뒤에는 클릭해 실제 목적지가 맞는지 확인합니다. 괄호가 빠지거나 주소 중간에 공백이 들어가면 링크 대신 원문 기호가 보일 수 있습니다. 출처 주소를 다른 페이지로 바꾸어 쓰지 말고, 본문에서 설명한 내용을 직접 확인할 수 있는 경로를 선택하세요. 로그인 전용 주소와 일시적으로만 유효한 다운로드 주소는 공개 안내의 출처로 적절한지도 검토해야 합니다.

표는 확장 문법 지원 여부부터 확인하세요

표는 항목을 같은 기준으로 비교할 때 유용합니다. GitHub에서는 세로줄로 열을 나누고 구분 행에 하이픈을 넣는 문법을 지원합니다. 표 위에는 빈 줄을 넣고 열마다 같은 개수의 셀을 유지하세요. 아래는 작성자가 직접 만든 짧은 비교 예시이며, 특정 서비스의 실제 요금표가 아닙니다.

| 준비 방법 | 확인할 항목 |
| --- | --- |
| 온라인 예약 | 날짜와 예약번호 |
| 현장 접수 | 운영시간과 준비물 |

표가 위와 같이 보이지 않고 세로줄이 그대로 나타나면 사용 중인 편집기가 표를 지원하는지 확인합니다. 표 문법은 모든 기본 마크다운 구현의 공통 기능이라고 가정하면 안 됩니다. 모바일에서는 열이 많은 표보다 두세 열로 비교 기준을 줄이는 편이 읽기 좋습니다. 셀 안에 긴 문장을 넣어야 한다면 본문 설명으로 옮길 수 있는지도 살펴보세요.

저장 전 미리보기에서 확인할 다섯 가지

줄바꿈 한 번이 화면의 줄바꿈으로 처리되는지는 서비스에 따라 다릅니다. 문단을 확실히 나눌 때는 빈 줄을 두고, 코드나 문법을 그대로 보여줄 때는 코드 블록을 사용합니다. 문법을 설명하는 글에서 예시까지 실제 제목으로 바뀌면 독자가 입력할 문자를 구분하기 어렵습니다. 원고 화면과 읽기 화면을 오가며 확인하세요.

• 제목의 단계가 내용의 큰 절과 작은 절을 제대로 구분하는가?
• 목록 기호 다음에 공백이 있고 항목이 의도대로 묶이는가?
• 강조가 과하지 않고 중요한 조건에만 적용되는가?
• 표와 링크가 실제 발행 화면에서도 정상 동작하는가?
• 휴대폰에서 긴 코드와 표가 본문 전체를 가로로 밀어내지 않는가?

처음에는 제목, 문단, 목록만 사용해 한 편을 완성해보세요. 필요한 부분에 강조와 링크를 더하고 비교할 내용이 있을 때 표를 추가하면 됩니다. 서식을 많이 쓰는 것보다 독자가 내용을 찾기 쉬운 구조가 우선입니다. 문장이 길어 구조를 잡기 어렵다면 AI 초안 편집 예시를 함께 살펴볼 수 있습니다.