마크다운 문법 정리 – 블로거와 개발자를 위한 실전 가이드
글을 쓸 때 서식을 빠르게 적용하고 싶다면 마크다운 문법을 익혀두는 것이 좋다. 마크다운은 텍스트 기반의 경량 마크업 언어로, 깃허브, 노션, 옵시디언, 티스토리 등 다양한 플랫폼에서 사용된다. 복잡한 HTML을 몰라도 깔끔한 문서를 만들 수 있다는 점이 마크다운 문법의 가장 큰 장점이다.
마크다운이란 무엇인가
마크다운(Markdown)은 2004년 존 그루버가 만든 텍스트 포맷팅 문법이다. 일반 텍스트에 간단한 기호를 붙여 제목, 목록, 링크, 이미지 등의 서식을 표현할 수 있다. HTML로 변환이 쉽기 때문에 웹 콘텐츠 작성에 특히 유용하다.
마크다운 문법이 인기를 끄는 이유는 단순하다. 배우기 쉽고, 어디서든 사용할 수 있으며, 결과물이 깔끔하다. 워드프로세서처럼 마우스로 서식을 지정할 필요 없이, 키보드만으로 모든 포맷팅이 가능하다는 점도 생산성을 높여준다.
2004
마크다운 최초 공개 연도
80%+
깃허브 문서에서의 마크다운 사용 비율
5분
기본 문법 습득 소요 시간
마크다운 기본 문법 총정리
마크다운 문법의 핵심은 몇 가지 기호의 조합이다. 아래 표에 가장 많이 쓰이는 기본 문법을 정리했다.
| 문법 | 작성법 | 결과 |
|---|---|---|
| 제목 | # ~ ###### | H1 ~ H6 |
| 굵게 | **텍스트** | 텍스트 |
| 기울임 | *텍스트* | 텍스트 |
| 링크 | [텍스트](URL) | 하이퍼링크 |
| 이미지 |  | 이미지 삽입 |
| 코드 | `코드` 또는 “`블록“` | 코드 강조 |
마크다운 문법에서 가장 먼저 익혀야 할 것은 제목(#)과 목록(- 또는 1.)이다. 이 두 가지만 알아도 기본적인 문서 구조를 잡을 수 있다.
플랫폼별 마크다운 활용법
마크다운 문법은 플랫폼에 따라 약간씩 확장된 기능을 제공한다. 깃허브에서는 체크박스, 테이블, 이모지 코드를 지원하고, 노션에서는 토글, 데이터베이스 연동까지 가능하다.
- 깃허브 – README, 이슈, PR 작성에 마크다운이 기본이다. GFM(GitHub Flavored Markdown) 확장 문법을 지원한다
- 노션 – 슬래시(/) 명령어와 마크다운 문법을 동시에 사용할 수 있다. 제목, 토글, 콜아웃 등이 자동 변환된다
- 옵시디언 – 로컬 파일 기반의 메모 앱으로, 마크다운 문법으로 작성한 노트끼리 양방향 링크가 가능하다
- 티스토리 – 글쓰기 모드에서 마크다운을 지원한다. HTML 모드 전환 없이 서식 적용이 가능하다
- 벨로그 – 개발자 블로그 플랫폼으로, 마크다운 전용 에디터를 제공한다
마크다운 작성 시 알아두면 좋은 팁
마크다운 문법을 좀 더 효율적으로 활용하려면 몇 가지 실전 팁을 기억해 두자. 기본 문법만으로는 해결하기 어려운 상황에서 유용하다.
▲ 줄바꿈 – 마크다운에서 엔터 한 번은 줄바꿈이 아니다. 문장 끝에 공백 두 칸을 넣거나, 빈 줄을 하나 추가해야 한다. 이 부분에서 초보자가 가장 많이 혼란을 겪는다.
▲ HTML 혼용 – 마크다운 문법만으로 표현이 어려운 경우 HTML 태그를 직접 사용할 수 있다. 예를 들어 이미지 크기 조절이나 색상 적용은 HTML이 더 편리하다.
핵심 포인트
마크다운 문법은 완벽하게 외울 필요가 없다. 자주 쓰는 5~6가지 문법만 손에 익히면 나머지는 필요할 때 찾아서 쓰면 된다. 핵심은 반복 사용이다.
마크다운 에디터 추천
마크다운 문법을 연습하고 실제 작업에 활용하려면 좋은 에디터를 선택하는 것이 중요하다. 실시간 미리보기를 지원하는 에디터를 사용하면 작성 결과를 바로 확인할 수 있어 학습 속도가 빨라진다.
무료 에디터로는 VS Code(마크다운 미리보기 내장), Typora(소폭 유료 전환), StackEdit(웹 기반 무료)가 대표적이다. 모바일에서는 iA Writer, Bear 등이 인기다. 어떤 에디터를 선택하든 마크다운 문법의 핵심은 동일하니, 자신의 작업 환경에 맞는 것을 고르면 된다.
“마크다운 문법은 글쓰기의 진입 장벽을 낮추고, 콘텐츠 자체에 집중하게 만드는 가장 실용적인 도구다.”
자주 묻는 질문 FAQ
Q. 마크다운 문법을 배우는 데 얼마나 걸리나?
A. 기본 문법(제목, 목록, 링크, 굵게/기울임)은 5~10분이면 충분하다. 테이블, 코드 블록 등 확장 문법까지 포함해도 하루면 전체를 훑어볼 수 있다.
Q. 마크다운으로 작성한 문서를 PDF로 변환할 수 있나?
A. 가능하다. VS Code의 Markdown PDF 확장, Typora의 내보내기 기능, Pandoc 같은 변환 도구를 사용하면 마크다운 파일을 PDF, DOCX, HTML 등 다양한 형식으로 변환할 수 있다.
Q. 워드프레스 블로그에서 마크다운을 사용할 수 있나?
A. 기본적으로는 지원하지 않지만, Jetpack 플러그인의 마크다운 모듈을 활성화하거나, WP Githuber MD 같은 전용 플러그인을 설치하면 마크다운 문법으로 글을 작성할 수 있다.
