개발자

마크다운 문법 총정리 치트시트 2026: 초보자를 위한 완벽 가이드

제목, 굵은 글씨, 링크, 이미지 삽입부터 테이블, 코드 블록, 체크리스트까지 마크다운 작성에 필요한 모든 문법을 총정리하고 실시간 미리보기 에디터로 연습해봅니다.

2026년 4월 1일7분 읽기

마크다운 문법 총정리 치트시트 2026: 초보자를 위한 완벽 가이드

GitHub에서 README를 작성하거나, 노션, 옵시디언, 벨로그, 디스코드에서 글을 쓴 경험이 있다면, 이미 마크다운(Markdown) 을 사용하고 있는 것입니다. 2004년 존 그루버가 만든 마크다운은 복잡한 HTML 태그 대신 직관적인 기호만으로 텍스트를 서식화할 수 있는 경량 마크업 언어입니다.

마크다운은 기술 문서 작성의 세계 표준 언어로 자리 잡았습니다. 개발자 블로그, 정적 사이트 생성기(Jekyll, Hugo, Gatsby), 슬랙이나 디스코드 같은 메신저까지 마크다운을 네이티브로 렌더링합니다.

제목(Heading): 문서 구조 잡기

줄 맨 앞에 #을 붙여서 만듭니다. # 제목 1 (최상위 제목), ## 제목 2 (섹션), ### 제목 3 (하위 섹션) 식으로 6단계까지 지원합니다. # 뒤에 반드시 띄어쓰기를 넣어야 합니다—이 공백을 빠뜨리는 것이 초보자들의 가장 흔한 실수입니다.

텍스트 꾸미기

  • 굵게: **굵은 글씨**
  • 기울임: *기울인 글씨*
  • 취소선: ~~지운 글씨~~
  • 인라인 코드: 백틱 한 개

링크, 이미지, 목록

하이퍼링크: [텍스트](URL). 이미지: ![설명](이미지URL). 순서 없는 목록은 -, 순서 있는 목록은 1.. 들여쓰기로 중첩 가능합니다.

코드 블록: 개발자의 핵심 무기

여러 줄의 코드 블록은 백틱 3개로 감싸며 언어명을 명시하면 구문 강조가 적용됩니다. 깃허브, 깃랩 등 주요 플랫폼에서 아름다운 컬러 하이라이팅으로 렌더링됩니다.

테이블(표)

파이프(|)와 하이픈(-)을 조합하여 표를 만듭니다. 콜론(:)으로 정렬을 제어합니다.

체크리스트, 인용문 등

GFM은 인터랙티브 체크리스트(- [x] 완료, - [ ] 할일), > 인용문, --- 구분선을 지원합니다.

실시간 에디터로 직접 연습하기

UtiliZest의 마크다운 에디터는 왼쪽에 원시 마크다운을 입력하면 오른쪽에 결과가 즉시 나타나는 분할 화면 라이브 프리뷰를 무료로 제공합니다. GFM 테이블, 체크리스트, 코드 하이라이팅을 완벽 지원합니다.

markdown editor 바로 사용하기

자주 묻는 질문

마크다운과 HTML은 어떤 관계인가요?
HTML은 복잡한 태그를 사용하고, 마크다운은 간단한 기호로 같은 결과를 냅니다. 내부적으로 마크다운은 항상 HTML로 변환됩니다.
GFM(GitHub Flavored Markdown)이란?
깃허브가 표준 마크다운에 테이블, 체크리스트, 취소선, 코드 하이라이팅 등을 추가한 확장 버전입니다. 대부분의 모던 플랫폼이 GFM을 지원합니다.
마크다운으로 웹사이트를 만들 수 있나요?
네! Jekyll, Hugo, Gatsby, Astro, Next.js(MDX) 같은 정적 사이트 생성기가 마크다운을 HTML 웹 페이지로 변환합니다.
마크다운에서 줄바꿈이 안 됩니다.
엔터 한 번으로는 줄이 바뀌지 않습니다. 줄 끝에 스페이스 2칸 + 엔터, 또는 빈 줄 한 줄을 넣으세요.
마크다운 미리보기를 할 수 있나요?
UtiliZest의 마크다운 에디터에서 타이핑과 동시에 실시간 렌더링 결과를 확인할 수 있습니다.

관련 글