.md 파일이란? 쉬운 설명

.md 파일은 Markdown이라는 방식으로 쓴 평범한 텍스트 문서입니다. 그 안에 보이는 #, **, -, | 같은 기호는 텍스트가 어떻게 보여야 하는지 알려 주는 지시입니다. 이 줄은 제목, 이 단어는 굵게, 이 줄들은 목록이라는 뜻입니다. Markdown을 이해하는 앱은 기호를 숨기고 서식을 보여 줍니다. 이해하지 못하는 앱, 예를 들어 텍스트 편집기는 기호를 그대로 보여 줍니다.

한 문단으로 보는 Markdown

Word 파일이나 PDF처럼 익숙한 문서는 대부분 서식을 눈에 보이지 않는 층에 보관합니다. Markdown은 반대입니다. 서식을 평범한 키보드 문자로 텍스트 안에 직접 씁니다. 파일은 그냥 텍스트라서 어떤 컴퓨터에서든 열리고, 용량이 거의 없으며, 30년 뒤에도 읽을 수 있습니다. 대신 기호를 읽어 서식으로 바꿔 주는 앱이 필요하고, 없으면 기호가 날것 그대로 보입니다.

누가, 왜 만들었나

Markdown은 블로그 Daring Fireball의 필자 존 그루버가 프로그래머 에런 스워츠의 큰 도움을 받아 만들어 2004년에 공개했습니다. 그루버는 HTML을 입력하지 않고 웹용 글을 쓰고 싶었고, 무엇보다 한 가지 원칙을 앞세웠습니다. Markdown 문서는 서식 명령으로 뒤덮인 것처럼 보이지 않고, 일반 텍스트 상태 그대로 읽을 수 있어야 한다는 것입니다.

그래서 기호는 강조하려는 단어를 별표로 감싸는 것처럼 사람들이 텍스트 이메일에서 이미 쓰던 습관에서 가져왔습니다. 원본 .md 파일이 어수선해도 대체로 읽을 수 있는 이유입니다.

이후 다른 사람들이 원래 버전에 없던 기능을 추가했습니다. 오늘날 가장 널리 쓰이는 것은 표, 체크리스트, 취소선을 더한 GitHub Flavored Markdown입니다. 요즘 ‘Markdown’이라고 하면 대개 이것을 가리킵니다.

AI가 Markdown으로 쓰는 이유

ChatGPT, Claude, Gemini, Copilot이 답할 때 쓰는 텍스트는 대개 Markdown입니다. 채팅 화면이 기호를 제목, 굵은 글씨, 표로 바꾼 다음에 보여 주기 때문에 알아채기 어렵습니다. 이 형식은 AI에 잘 맞습니다. 간결하고, 앱 사이를 복사해도 망가지지 않으며, AI가 학습한 기술 문서에서 흔히 쓰이기 때문입니다.

문제는 답변이 채팅 밖으로 나갈 때 생깁니다. ‘파일로’ 달라고 하면 .md를 받습니다. 기호까지 포함한 같은 텍스트이고, 그것을 바꿔 줄 것이 없습니다. Markdown을 이해하지 못하는 앱에 답변을 복사하면 별표도 함께 따라옵니다.

기호의 의미

AI가 쓴 문서 거의 어디에서나 만나게 되는 기호들입니다.

파일에 보이는 것	의미
# 제목	가장 큰 제목
## 섹션, ### 하위 섹션	더 작은 제목. #가 많을수록 작아진다
**중요**	굵게: 중요
*메모* 또는 _메모_	기울임
- 항목 또는 * 항목	글머리 기호 목록
1. 항목	번호 목록
- [ ] 할 일과 - [x] 완료	체크리스트. 빈 상자와 체크된 상자
[보고서](https://example.com)	링크. 대괄호 안에 글자, 소괄호 안에 주소
> 인용문	인용. 들여쓰기로 표시된다
`코드`	기술 용어나 짧은 코드. 고정폭 서체로 표시된다
백틱 세 개만 있는 줄	코드 블록의 시작 또는 끝
세로선으로 구분된 단어들의 줄	표(아래 참고)

원본 상태에서 가장 겁나 보이는 것이 표이므로 예를 하나 들겠습니다.

| 품목   | 가격    |
| ------ | ------- |
| 커피   | 4,500원 |
| 케이크 | 6,000원 |

첫 줄은 머리글 행이고, 하이픈으로 된 줄이 그것을 나머지와 구분하며, 그다음 줄 하나하나가 표의 행입니다. 세로선은 한 열이 끝나고 다음 열이 시작되는 자리를 나타냅니다. 제대로 표시하면 두 열, 두 행짜리 평범한 작은 표입니다.

가끔 다른 기호도 나옵니다. 취소선의 ~~텍스트~~, 구분선이 되는 ---만 있는 줄, 이미지를 뜻하는 ![설명](picture.png)입니다. 이 정도면 거의 전부입니다.

Mac이 기호를 보여 주는 이유

macOS에는 Markdown을 읽는 기능이 내장되어 있지 않습니다. 시스템이 보기에 .md 파일은 일반 텍스트이므로, 이중 클릭하면 일반 텍스트를 담당하는 앱, 보통은 텍스트 편집기에서 열리고 Apple 개발 도구가 설치되어 있으면 Xcode에서 열립니다. 둘 다 파일에 든 것을 기호까지 그대로 보여 줍니다. Finder에서 스페이스 바를 눌러도 Markdown 미리보기를 추가한 앱이 없으면 마찬가지입니다. 파일은 정상이고, Mac이 표시하는 방법을 모를 뿐입니다.

제대로 여는 방법

• 한 번만, 아무것도 설치하지 않고: 텍스트 편집기에서 열고 기호를 건너뛰며 읽습니다. 짧은 메모라면 참을 만하지만 긴 표라면 괴롭습니다.
• 클라우드에서: .md 파일을 Google Drive에 올리면 Google Docs로 열 수 있습니다. 동작은 하지만 파일을 어딘가에 올려야 하므로, 개인적인 문서라면 신중히 결정할 일입니다.
• 코드 편집기에서: VS Code는 ⇧⌘V를 누르면 서식이 적용된 미리보기를 보여 줍니다. 되기는 하지만 프로그래머용 도구이고 생김새도 그렇습니다.
• Markdown 앱에서: Hem은 바로 이 용도로 만든 무료 오픈 소스 Mac 앱입니다. 처음 실행하면 .md 파일을 여는 앱이 될지 묻고, 그 뒤로는 이중 클릭하면 서식이 적용된 페이지가, Finder에서 스페이스 바를 누르면 서식이 적용된 미리보기가 나타납니다. 파일은 Mac에 그대로 있습니다. Hem은 Mac 전용입니다.

AI 채팅에서 받은 파일이라면 ChatGPT가 .md 파일을 줬을 때에서 이어서 읽어 보세요.

편집하는 방법

.md 파일은 텍스트일 뿐이므로 어떤 텍스트 편집기로도 고칠 수 있습니다. 다만 기호를 편집하게 됩니다. 단어를 굵게 하려면 양옆에 별표를 두 개씩 입력해야 하고, 결과는 미리보기로 확인해야 합니다.

그런 것을 배우고 싶지 않다면 작업하는 동안 기호를 숨겨 주는 앱을 쓰세요. Hem에서는 서식이 적용된 페이지를 클릭하고 입력합니다. Pages나 Word와 거의 같은 느낌입니다. 텍스트를 선택하면 굵게, 기울임, 제목, 목록, 체크리스트, 링크, 인용이 있는 작은 막대가 나타납니다. ⌘B와 ⌘I는 익숙한 대로 동작하고, 포맷 › ‘표 삽입’으로 표를 추가하며, 체크 상자는 클릭으로 표시합니다. Hem은 같은 .md 파일에 바로바로 저장하고 바꾼 부분만 다시 씁니다. 파일은 AI 도구나 다른 앱이 읽을 수 있는 평범한 Markdown으로 남습니다.

변환하는 방법

• Word로: Hem에서 파일 › ‘Word 문서로 내보내기…’를 선택하면 .docx가 저장됩니다. Google Docs를 쓰는 방법 등은 .md 파일을 Word 문서로 바꾸는 방법에 있습니다.
• PDF로: Hem에서 파일 › ‘PDF로 내보내기…’.
• 이메일이나 다른 문서로: Hem에서 ⌘C로 복사해 Mail, Word, Pages, Google Docs에 붙여 넣습니다. 제목, 굵은 글씨, 목록, 표가 기호가 아니라 서식으로 들어갑니다.
• 다시 AI에게: 변환할 필요가 없습니다. AI 채팅은 Markdown을 무리 없이 읽으므로 텍스트를 붙여 넣거나 .md 파일을 그대로 첨부하세요.

요약

.md 파일은 서식이 기호로 적혀 있는 텍스트 문서입니다. 고장 난 것도, 위험한 것도, 프로그래머만의 것도 아닙니다. 기호를 읽어 주는 앱이 필요할 뿐이고, Mac에는 기본으로 들어 있지 않아 직접 추가해야 합니다.