마크다운 미리보기 가이드 — 문법부터 실시간 편집까지

마크다운(Markdown)은 텍스트에 간단한 기호를 붙여서 서식을 표현하는 경량 마크업 언어예요. 2004년에 존 그루버가 만들었고, 지금은 개발자뿐 아니라 블로거, 작가, 기획자까지 폭넓게 사용하고 있어요. 마크다운이 인기 있는 이유는 간단해요. 첫째, 배우기 쉬워요. HTML처럼 복잡한 태그를 외울 필요 없이 #, *, - 같은 기호 몇 개만 알면 돼요. 둘째, 어디서든 사용할 수 있어요. GitHub, Notion, Slack, Discord, 블로그 플랫폼 등 수많은 서비스가 마크다운을 지원해요. 셋째, 일반 텍스트 파일이라 어떤 에디터에서든 열 수 있고, 용량이 작고, 버전 관리가 쉬워요. 특히 개발 문서를 작성할 때 마크다운이 사실상 표준이에요. GitHub의 README.md, 기술 블로그, API 문서 등 대부분이 마크다운으로 작성돼요. 한번 익혀두면 활용할 곳이 정말 많아요.

실무에서 가장 자주 쓰는 마크다운 문법을 정리할게요. 제목은 #의 개수로 단계를 나눠요. #은 H1, ##은 H2, ###은 H3이에요. 보통 H1은 문서 제목에 하나만 사용하고, 본문에서는 H2와 H3를 주로 써요. 텍스트 강조는 별표(*)를 사용해요. *기울임*, **굵게**, ***굵은 기울임***으로 표현할 수 있어요. 취소선은 물결표(~~) 두 개로 감싸면 돼요. 목록은 순서 없는 목록(-, *, +)과 순서 있는 목록(1., 2., 3.)이 있어요. 들여쓰기로 하위 목록을 만들 수 있어요. 링크는 대괄호와 소괄호를 사용해요. 표시할 텍스트를 대괄호에, URL을 소괄호에 넣으면 돼요. 이미지는 앞에 느낌표(!)를 붙이면 돼요. 코드는 백틱(`)으로 감싸면 인라인 코드가 되고, 백틱 세 개로 감싸면 코드 블록이 돼요. 언어 이름을 붙이면 구문 강조(syntax highlighting)도 적용돼요. 인용은 > 기호를 사용해요. 여러 줄 인용도 가능하고, 중첩 인용(>>)도 돼요.

마크다운은 일반 텍스트이기 때문에 작성 중에 최종 결과물이 어떻게 보일지 바로 확인하기 어려워요. 특히 복잡한 표(table), 중첩 목록, 코드 블록이 포함된 문서는 렌더링 결과를 실시간으로 확인하면서 작성하는 게 훨씬 효율적이에요. Toolkio의 마크다운 미리보기 도구를 사용하면 왼쪽에 마크다운을 작성하면서 오른쪽에서 렌더링된 결과를 실시간으로 볼 수 있어요. 타이핑하는 즉시 결과가 업데이트되니까 문법 실수를 바로 잡을 수 있어요. 표를 만들 때 특히 유용해요. 마크다운 표는 파이프(|)와 하이픈(-)으로 구성하는데, 정렬이 맞지 않으면 깨져 보일 수 있거든요. 미리보기를 보면서 작성하면 표가 제대로 표시되는지 바로 확인할 수 있어요. GitHub README를 작성할 때도 커밋하기 전에 미리보기 도구에서 먼저 확인하면 시행착오를 줄일 수 있어요. 전체 내용을 복사해서 Toolkio에 붙여넣으면 GitHub에서 보이는 것과 거의 동일한 결과를 미리 확인할 수 있어요.

마크다운을 더 효과적으로 사용하는 팁들을 공유할게요. 줄바꿈에 주의하세요. 마크다운에서 엔터 한 번은 줄바꿈이 아니에요. 줄 끝에 공백 두 칸을 넣거나 빈 줄을 추가해야 실제로 줄이 바뀌어요. 이걸 모르면 문단이 붙어 보이는 문제가 생겨요. 체크박스 목록을 활용하세요. - 뒤에 대괄호와 공백([ ])을 넣으면 체크박스가 만들어져요. 완료된 항목은 [x]로 표시해요. TODO 목록이나 프로젝트 진행 상황을 추적할 때 편리해요. 접기/펼치기(details)를 사용해보세요. HTML의 details 태그는 대부분의 마크다운 렌더러에서 지원해요. 긴 로그, 설정 파일 등을 접어두면 문서가 깔끔해져요. 이모지도 사용할 수 있어요. GitHub 스타일 마크다운에서는 콜론으로 감싼 이모지 코드를 지원해요. 문서에 시각적 포인트를 줄 때 유용해요. 마지막으로, Toolkio의 마크다운 미리보기 도구에서 연습하는 걸 추천해요. 새로운 문법을 배울 때마다 바로 입력해서 결과를 확인하면 기억에 더 오래 남아요.