마크다운(md 파일) — ClaudeCode를 활용한 바이브코딩 강의

마크다운 파일, Markdown 파일, md 파일은 같은 종류의 문서를 가리키는 말입니다. 글자만 저장하는 텍스트 파일에 제목·목록 같은 간단한 작성 규칙을 적용하고, 보통 .md라는 확장자로 저장합니다.

1. txt·md·csv는 모두 텍스트 파일입니다

중요도	예	담는 내용	알맞은 용도
중요	`memo.txt`	일반 글과 줄바꿈	간단한 메모, 오류 메시지 저장
핵심	`README.md`	글과 함께 제목·목록·링크 등 Markdown 기호	프로젝트 설명, 강의 원고, 작업 지침
중요	`students.csv`	쉼표 등으로 구분한 표 데이터	명단, 수치 자료, 표 데이터 교환

셋 모두 텍스트 편집기로 열어 글자를 확인할 수 있습니다. .txt만 텍스트 파일인 것은 아닙니다. .md는 내용을 보여 주는 앱에 따라 기호가 보이는 원문으로 열리거나, 제목·목록으로 꾸며진 미리보기로 열립니다.

CSV도 텍스트 파일이며 엑셀에서 표로 열 수 있습니다. 다만 엑셀 통합문서 .xlsx와는 다릅니다. CSV를 열 때 한글이나 00123 같은 값이 달라지면 ‘데이터 → 텍스트/CSV에서’ 가져오기에서 문자와 열 형식을 확인합니다.

중요도	직접 쓰는 글자	미리보기에서의 뜻
핵심	`# 강의 제목`	큰 제목
중요	`## 오늘 할 일`	그 아래 단계의 제목
핵심	`- 자료 읽기`	목록 항목
중요	`1. 폴더 열기`	번호가 있는 목록
중요	`중요한 내용`	중요한 내용
중요	`[오라클 안내](https://www.oracle.com/kr/cloud/free/)`	클릭 가능한 링크
중요	`pwd`	문장 안의 짧은 코드·명령어
참고	`> 참고 문장`	인용문

#와 - 뒤에는 공백을 넣습니다. 문단 사이는 빈 줄로 나누면 읽기 쉽습니다. 여러 줄의 코드는 앞뒤를 백틱 세 개로 감쌉니다. 백틱은 작은따옴표와 다른 글자입니다.

```text
pwd
ls
```

| 명령 | 하는 일 |
| --- | --- |
| pwd | 현재 위치 확인 |
| ls | 파일 목록 보기 |

표를 지원하는 미리보기에서는 다음처럼 보입니다.

중요도	명령	하는 일
핵심	pwd	현재 위치 확인
핵심	ls	파일 목록 보기

표의 열을 나누는 기호는 |입니다. \|는 표 안에서 세로줄 자체를 글자로 쓰고 싶을 때 사용합니다. 표와 체크박스 등은 Markdown 확장 기능이므로 모든 앱에서 같은 모양으로 표시되지는 않습니다.

VS Code 같은 텍스트 편집기에서 새 파일을 만듭니다.
아래 예시를 입력하고 프로젝트 폴더에 lesson.md로 저장합니다.
실제 이름이 lesson.md.txt가 아닌지 확인합니다.
VS Code에서 ‘Markdown: Open Preview’ 명령 또는 미리보기 버튼으로 결과를 확인합니다. 원문 편집으로 돌아와 고치고 저장합니다.

# 첫 번째 강의

## 오늘 할 일

- 프로젝트 폴더 열기
- pwd로 위치 확인하기
- 결과를 memo.txt에 기록하기

## 질문

터미널의 현재 위치와 프로젝트 폴더는 어떻게 다릅니까?

Windows 메모장도 텍스트를 편집할 수 있습니다. macOS TextEdit을 사용한다면 ‘일반 텍스트’ 형식으로 작성합니다. Word 문서의 확장자만 .md로 바꾸는 것은 Markdown으로 변환하는 방법이 아닙니다.

열기와 미리보기: VS Code Markdown 문서.

제목과 목록으로 내용을 나누면 사람과 AI 모두 문서의 구조를 파악하기 쉽습니다. “모든 AI가 다른 형식보다 항상 가장 잘 읽는다”는 뜻은 아닙니다. 설명문은 md, 표 데이터는 csv처럼 내용에 맞게 고릅니다.

이 프로젝트 폴더에 lesson.md를 만들어 줘.
제목은 '터미널 첫걸음'으로 하고,
목표, 필수 명령어, 실습 순서, 확인 질문으로 나눠 줘.
완료되면 저장한 파일의 전체 경로를 알려 줘.

기존 파일을 고칠 때는 파일 경로와 고칠 부분을 함께 알려 줍니다. SSH 환경에서는 원격 컴퓨터에 실제로 있는 md 파일의 경로를 전달합니다.