바이브코딩 부록 · 개념편 ②

마크다운 — 기호 몇 개로 글을 꾸미는 법

언제 보나 README·옵시디언·AI 답변에서 기호가 나올 때
한 줄 정의 기호(#, -, **)로 제목·목록·강조를 만드는 쉬운 표기법
짝 모듈 M13 (README)

1한 줄로

마크다운 = 카톡에서 *별표*로 강조하듯, 글에 기호 몇 개를 붙여 제목·목록·굵게를 만드는 아주 쉬운 표기법입니다. 프로그램 없이 메모장만으로도 깔끔한 문서가 됩니다.
내가 쓴 것 (기호) # 내 소개 **스피치 강사**입니다 ## 하는 일 - 1:1 스피치 코칭 - 방송 발표 트레이닝 > 믿고 맡기세요 변환 화면에 보이는 것 내 소개 스피치 강사입니다 하는 일 1:1 스피치 코칭 방송 발표 트레이닝 믿고 맡기세요
같은 내용이라도 앞에 기호(#, **, -, >)를 붙이면 → 제목·굵게·목록·인용으로 깔끔하게 바뀝니다.

워드처럼 버튼을 누르는 게 아니라, 글자 앞에 기호를 붙이는 방식이에요. 이 부록도, 챗GPT·클로드의 답변도, 옵시디언 메모도 전부 마크다운입니다. 한 번 익히면 어디서나 똑같이 통합니다.

2좀 더 자세히 — 왜 이렇게 쓰나

예전에는 글을 예쁘게 만들려면 무거운 프로그램(워드 등)을 켜고 마우스로 버튼을 눌러야 했습니다. 마크다운은 글자만으로 서식을 표현하자는 약속이에요. # 하나로 제목이 되고, - 하나로 목록이 됩니다.

그래서 어디서나 통합니다. 메모장, 카톡 비슷한 채팅, README 파일, 옵시디언, AI 채팅창 — 프로그램을 안 가려요. 또 나중에 자동으로 예쁘게 변환됩니다. 내가 # 제목이라고 쓰면, 화면에 띄울 때 컴퓨터가 알아서 큰 제목으로 바꿔 보여줍니다(위 그림).

바이브코딩에서 가장 먼저 만나는 마크다운은 README.md입니다. 내 프로젝트의 "표지 겸 자기소개서" 같은 파일인데, 여기에 마크다운으로 몇 줄만 적어도 GitHub에서 깔끔한 소개 페이지가 됩니다.

3핵심 기호표 (이것만 알면 90%)

이렇게 쓰면이렇게 보입니다
# 제목가장 큰 제목
## 소제목한 단계 작은 제목 (#이 많을수록 작아짐)
- 사과 / - 배· 사과   · 배 (동그라미 목록)
1. 첫째1. 첫째 (번호 목록)
**중요**중요 (굵게)
[스마택트](https://smartact.kr)파란 링크
> 인용왼쪽에 세로줄 있는 인용문
`코드`회색 상자 안 글자 (코드 표시)
챗GPT에게 "내 소개 글 써줘" 했더니 제목·목록으로 깔끔하게 정리된 답이 나왔습니다. 그게 바로 마크다운이에요. 그 답을 그대로 복사해서 내 README.md에 붙이면, GitHub에서도 똑같이 제목·목록으로 예쁘게 보입니다. 다시 꾸밀 필요가 없어요.
마크다운은 글자 앞에 기호를 붙이는 것. #은 제목, -는 목록, **는 굵게. 딱 이 셋만 기억하세요.

4직접 해보기

아래 칸에, 내 이름을 # 제목으로 + 좋아하는 것 2가지를 - 목록으로 손으로 적어보세요.

가져갈 문장 3개.
  1. "마크다운은 기호로 글을 꾸미는 법 — 워드 버튼 대신 기호."
  2. "#=제목, -=목록, **=굵게. 이 셋이 90%."
  3. "기호 다음엔 한 칸 띄우기, 굵게는 양쪽 다 붙이기."