마크다운 뜻과 문법 정리: md 파일 쓰는 법과 여는 법

마크다운(Markdown)은 글자 앞에 기호를 붙여 문서의 구조를 표시하는 서식 방법입니다. 그렇게 쓴 글을 확장자 .md로 저장한 파일을 md 파일이라고 부릅니다. 종이 원고에 연필로 동그라미를 쳐서 이 줄이 제목이라고 표시해 두면 인쇄소가 그 표시를 보고 큰 활자로 찍어 내듯, 줄 앞에 #을 하나 붙여 두면 프로그램이 그 기호를 보고 그 줄을 제목 크기로 키워 보여 줍니다.

기호로 서식을 만드는 방식은 이미 여러 곳에서 쓰이고 있습니다. 챗GPT와 제미나이가 답을 제목과 목록으로 나눠 내놓을 때 쓰는 것이 이 규칙이고, 깃허브(GitHub)에 올라오는 프로젝트 설명 문서도 대부분 md 파일입니다. 노션(Notion)에서 #과 스페이스를 눌러 제목을 만들어 본 적이 있다면 그때도 같은 방식을 쓴 것입니다.

막상 쓰려고 하면 정리된 기호 목록을 찾기가 어렵습니다. 제목은 몇 단계까지 되는지, 표는 어떻게 그리는지, 왜 어떤 화면에서는 표가 글자 그대로 보이는지를 설명한 자료가 여기저기 흩어져 있습니다. 모르는 채로 쓰면 회의록을 정리해 보냈는데 받는 쪽 화면에는 기호만 잔뜩 보이는 일이 생깁니다. 아래 문법은 2026년 9월 15일에 마크다운 원문 규칙과 CommonMark 표준 문서, 깃허브(GitHub) 공식 문서를 확인해 정리했습니다.

위 화면은 온라인 마크다운 편집기인 딜린저(Dillinger)입니다. 화면 위쪽 문서 이름 칸에 보이는 Untitled Document.md가 지금 편집 중인 md 파일입니다. 왼쪽에 기호를 붙인 글을 쓰면 오른쪽에 적용된 결과가 바로 나타납니다. 왼쪽의 ## Text Formatting은 오른쪽에서 굵은 소제목이 되었고, **bold**와 *italic*, ~~strikethrough~~도 각각 굵은 글씨와 기울임, 취소선으로 바뀌어 있습니다. 문법을 처음 익힐 때는 이렇게 입력과 결과가 함께 보이는 화면에서 연습하는 편이 빠릅니다.

마크다운 뜻과 md 파일의 관계

마크다운은 2004년에 존 그루버(John Gruber)가 공개했고, 공식 배포 페이지에 지금 올라와 있는 1.0.1판은 2004년 12월 17일 자입니다. 원문 규칙에 적힌 설계 목표는 하나였습니다. 기호를 붙여 놓아도 서식 지시가 달린 문서처럼 보이지 않고 보통의 글로 읽을 수 있게 만드는 것입니다.

HTML과 견주면 차이가 분명합니다. 같은 소제목을 만들 때 HTML은 <h2>소제목</h2>처럼 여는 태그와 닫는 태그로 감싸야 하지만, 마크다운은 ## 소제목 한 줄이면 됩니다. 마크다운으로 쓴 글은 프로그램이 읽어 들일 때 HTML로 바뀌므로, 화면에 나오는 결과는 같고 쓰는 수고만 줄어듭니다.

파일로 저장할 때 붙이는 확장자가 .md입니다. .markdown을 쓰기도 하지만 지금은 .md가 일반적입니다. 안에 들어 있는 것은 워드 파일 같은 전용 형식이 아니라 그냥 글자라서, 메모장으로 열어도 내용이 깨지지 않습니다.

정리하면 마크다운 파일이란 기호로 서식을 표시한 글을 그대로 담아 둔 텍스트 파일입니다. 특별한 프로그램 없이도 열리고, 마크다운을 아는 프로그램에서 열면 기호가 서식으로 바뀌어 보입니다.

한 장으로 보는 마크다운 문법표

연필로 남기는 교정 표시가 몇 가지로 정해져 있듯, 마크다운의 기호도 종류가 정해져 있습니다. 먼저 외울 아홉 가지를 추리면 이렇습니다. 나머지 문법은 뒤에서 하나씩 보겠습니다.

여기서 한 가지만 먼저 짚고 가겠습니다. 기호와 글자 사이는 반드시 한 칸 띄웁니다. #제목처럼 붙여 쓰면 제목이 되지 않고 #이 그대로 보입니다. 서식이 적용되지 않을 때 가장 먼저 확인할 것이 이 한 칸입니다.

제목과 강조, 목록 쓰는 법

제목은 # 개수로 단계를 정합니다

#은 여섯 개까지 쓸 수 있고, 개수가 늘어날수록 글자가 작아집니다. 한 문서 안에서 #은 한 번만 쓰고 그 아래를 ##과 ###으로 나누는 방식이 일반적입니다. 단계를 건너뛰지 않는 편이 좋습니다. ## 다음에 곧바로 ####가 오면 목차를 만드는 프로그램이 단계를 잘못 잡습니다.

강조는 기호로 감쌉니다

별표 두 개로 감싸면 굵게, 하나면 기울임입니다. 한국어에서는 기울임이 잘 드러나지 않아 굵게만 쓰는 경우가 많습니다. 물결표 두 개로 만드는 취소선은 표준이 아니라 뒤에서 다룰 확장 문법이라, 지원하지 않는 곳에서는 물결표가 지워지지 않고 남습니다. 파일 이름이나 명령어처럼 글자 그대로 보여야 하는 말은 백틱으로 감싸 인라인 코드로 적습니다. 백틱은 키보드에서 숫자 1 왼쪽에 있습니다.

목록은 하이픈이나 숫자로 시작합니다

점이 붙은 목록은 하이픈으로, 번호가 붙은 목록은 1.로 시작합니다. 번호는 전부 1.로 적어도 화면에는 1, 2, 3으로 나옵니다. 하위 항목은 앞에 공백 두 칸을 넣어 들여 씁니다. 대괄호 안에 공백이나 x를 넣으면 체크박스가 됩니다. 체크박스는 뒤에서 다룰 확장 문법이라 이를 지원하는 프로그램에서만 네모 칸으로 보입니다.

목록 앞뒤에는 빈 줄을 하나씩 넣는 편이 안전합니다. 하이픈 목록과 1.로 시작하는 목록은 앞 문단에 붙여 써도 목록으로 바뀌지만, 2.처럼 다른 번호로 시작하면 앞 문단에 딸려 들어가 한 문단이 됩니다.

링크와 이미지, 코드 블록, 표 쓰는 법

링크와 이미지는 대괄호와 소괄호로 씁니다

대괄호에 화면에 보일 글자를, 소괄호에 주소를 넣습니다. 앞에 느낌표를 붙이면 링크 대신 이미지가 됩니다. 이때 대괄호 안의 글자는 이미지가 뜨지 않을 때 대신 보이는 설명이 되므로, 무엇을 찍은 그림인지 적어 두는 편이 낫습니다.

인용문과 가로줄 넣기

꺾쇠 하나로 인용문을, 하이픈 세 개로 가로줄을 만듭니다. 인용문 안에서도 굵게와 링크가 그대로 적용됩니다.

코드 블록은 백틱 세 개로 감쌉니다

여러 줄을 글자 그대로 보여 줄 때는 백틱 세 개를 위아래에 놓습니다. 여는 쪽 백틱 뒤에 python이나 sql처럼 언어 이름을 적으면 코드에 색이 입혀집니다. 내용이 코드가 아니어도 상관없습니다. 설정값이나 로그처럼 줄바꿈을 그대로 두어야 하는 글에도 씁니다.

표는 세로선으로 칸을 나눕니다

세로선으로 칸을 나누고, 둘째 줄에 하이픈을 넣어 머리글과 내용을 구분합니다. 하이픈 줄에 콜론을 붙이면 정렬이 바뀝니다. :---는 왼쪽, :---:는 가운데, ---:는 오른쪽 정렬입니다. 세로선의 개수만 맞으면 원문에서 칸 너비가 들쭉날쭉해도 화면에서는 표가 가지런히 나옵니다.

프로그램마다 달라지는 마크다운 문법의 범위

같은 원고라도 연필 표시를 어디까지 알아보는지는 받는 사람마다 다르듯, 마크다운도 프로그램마다 알아보는 문법의 범위가 다릅니다. 기준이 되는 표준 문서는 CommonMark이고, 2026년 9월 15일 기준 최신판은 2024년 1월에 나온 0.31.2입니다. 그런데 이 표준에는 표와 체크박스, 취소선이 들어 있지 않습니다.

위 화면은 CommonMark 표준을 그대로 구현한 시험용 페이지입니다. 왼쪽에 넣은 제목과 목록, 인용문, 링크는 오른쪽에서 서식으로 바뀌었는데, 맨 아래 표만 세로선이 붙은 글자 그대로 남아 있습니다. 표가 표준 문법이 아니라서 생기는 차이입니다.

표와 체크박스는 깃허브가 만든 확장 규칙인 GFM(GitHub Flavored Markdown), 즉 깃허브식 마크다운에 들어 있습니다. 지금은 이 확장을 지원하는 프로그램이 많아 대부분의 화면에서 표가 그려지지만, 지원하지 않는 곳에서는 위 화면처럼 보입니다.

그래서 표나 체크박스를 넣기 전에 그 문서를 열어 볼 프로그램을 먼저 확인하는 편이 안전합니다. 깃허브와 노션, 옵시디언(Obsidian), VS Code는 모두 확장 문법을 지원합니다.

md 파일 여는 법과 저장할 때 확인할 점

md 파일은 전용 형식이 아니라 텍스트라서 글자를 읽을 수 있는 프로그램이면 어느 것으로나 열립니다. 다만 기호를 서식으로 바꿔 보여 주는지는 프로그램마다 다릅니다.

편집 화면과 미리 보기를 나란히 띄우려면 VS Code에서 Ctrl + K를 누른 뒤 V를 누릅니다. 맥은 Command + K에 이어 V입니다.

새로 만들 때는 메모장에서 글을 쓰고 저장할 때 파일 이름을 메모.md처럼 적으면 됩니다. 이때 두 가지 설정을 바꿉니다. 먼저 파일 형식을 모든 파일로 고릅니다. 그대로 두면 메모.md.txt로 저장됩니다. 그리고 인코딩을 UTF-8로 두어야 한국어가 깨지지 않습니다. 윈도우 메모장은 저장 창 아래쪽에서 둘 다 고를 수 있습니다.

확장자가 화면에 보이지 않으면 이름을 바꿔도 형식이 바뀌지 않습니다. 윈도우 탐색기는 보기 메뉴에서 파일 확장명을 켜고, 맥 파인더는 설정의 고급에서 모든 파일 확장자 보기를 켜면 됩니다.

회의록으로 연습하는 순서

복사해서 그대로 쓸 수 있는 예시를 하나 두겠습니다. 이름과 숫자만 바꾸면 그대로 회의록이 됩니다.

이 예시 하나에 제목과 두 종류의 목록, 체크박스, 인용문, 표가 모두 들어 있습니다. 메모장에 그대로 붙여 넣고 회의록.md로 저장한 다음 VS Code나 옵시디언에서 열어 보면, 적어 둔 기호가 어떤 서식으로 바뀌는지 한 번에 확인됩니다.

익숙해지는 순서도 정해 두면 편합니다. 첫 주에는 제목과 목록만 씁니다. 그다음에 굵게와 인용문을 더하고, 마지막에 표와 코드 블록을 붙입니다. 여기까지의 문법을 한꺼번에 외우려 하면 기억에 남지 않습니다.

AI 도구 설정 파일로 쓰이는 md 파일

요즘은 문서 서식을 넘어 AI 도구의 설정 파일에도 마크다운이 쓰입니다. 클로드 코드(Claude Code)의 CLAUDE.md나 작업 절차를 정의하는 SKILL.md가 그런 파일입니다. 기호 몇 개로 쓴 글이 그대로 AI의 행동 지침이 되기 때문에, 코딩을 몰라도 직접 쓸 수 있습니다.

이 글에서는 문법만 다룹니다. AI 쪽에서 왜 이 형식을 쓰게 되었는지는 AI 시대에 마크다운이 중요한 이유에 따로 정리해 두었습니다. 규칙 파일을 직접 만들어 보려면 클로드 코드 메모리와 CLAUDE.md부터 읽으면 됩니다.

자주 묻는 질문

마크다운 파일은 워드 파일과 무엇이 다른가요?

워드 파일은 글자와 함께 글꼴과 크기, 색 같은 서식 정보를 파일 안에 담아 둡니다. 그래서 워드나 한글 같은 전용 프로그램이 있어야 제대로 열립니다. 마크다운 파일에는 글자만 들어 있고 서식은 #이나 별표 같은 기호로 표시해 둡니다. 그래서 어떤 편집기에서나 열리고, 쓰던 프로그램이 바뀌어도 내용을 읽는 데 지장이 없습니다.

기호가 그대로 보이고 서식이 적용되지 않을 때는 무엇을 확인하나요?

세 가지를 확인합니다. 먼저 기호와 글자 사이를 한 칸 띄웠는지 봅니다. #제목은 제목이 되지 않습니다. 다음으로 목록 앞뒤에 빈 줄이 들어갔는지 확인합니다. 2.처럼 1이 아닌 번호로 시작하는 목록을 앞 문단에 붙여 쓰면 목록이 되지 않고 한 문단으로 묶입니다. 마지막으로 지금 보고 있는 것이 미리 보기인지 편집 화면인지 살펴봅니다. 편집 화면에서 기호가 보이는 것은 정상입니다.

표를 넣었는데 세로선이 그대로 보이는 이유는 무엇인가요?

표는 CommonMark 표준에 들어 있지 않은 확장 문법입니다. 깃허브식 마크다운을 지원하는 프로그램에서는 표로 그려지지만, 표준만 구현한 곳에서는 적어 둔 여러 줄이 세로선이 붙은 글자로 남습니다. 표가 꼭 필요한 문서라면 깃허브와 노션, 옵시디언, VS Code처럼 확장을 지원하는 곳에서 여는 편이 안전합니다.

정리: 아홉 가지 기호부터 익히는 순서

마크다운은 외울 것이 많아 보이지만 먼저 익힐 기호는 앞의 표에 담긴 아홉 가지입니다. #과 하이픈 두 가지만 써도 문서의 뼈대가 잡히고, 거기에 굵게와 인용문을 더하면 보고서 형태가 됩니다.

남는 문제는 완성한 md 파일을 어느 프로그램에서 여는지입니다. 같은 파일이라도 메모장에서는 기호가 보이고 옵시디언에서는 서식으로 보이며, 표준만 구현한 곳에서는 표가 글자로 남습니다. 문서를 넘기기 전에 받는 쪽이 어떤 프로그램으로 여는지 한 번 확인해 두면 기호만 잔뜩 보이는 화면을 피할 수 있습니다.

---

참고 자료

• Markdown, Daring Fireball
• Markdown: Syntax, Daring Fireball
• CommonMark Spec
• Basic writing and formatting syntax, GitHub Docs
• GitHub Flavored Markdown Spec