MD 파일 여는 법 — 프로그램 설치 없이 브라우저에서 바로

GitHub에서 받은 ZIP을 풀었습니다. README.md를 더블클릭했더니 메모장이 열리면서 이런 화면이 나타났습니다.

# 프로젝트 이름

## 소개

**빠르고** *가볍고* ~~복잡하지 않은~~ 도구입니다.

- 기능 1
- 기능 2

#이 뭔지, **가 뭔지 모르겠고 읽기도 불편합니다. MD 파일을 제대로 보려면 어떻게 해야 할까요?

MD 파일이란?

MD는 **Markdown(마크다운)**의 약자입니다. #은 제목, **텍스트**는 굵게, -는 목록을 의미하는 간단한 서식 기호입니다. 렌더링(Rendering)을 거치면 깔끔한 문서로 변환됩니다.

GitHub, Notion, Obsidian, 개발 문서 등 거의 모든 기술 문서가 .md 형식으로 작성됩니다. 자주 만나는 경우:

• GitHub 프로젝트의 README.md
• 오픈소스 라이브러리의 CHANGELOG.md, CONTRIBUTING.md
• 블로그 초안 (Gatsby, Jekyll, Hugo 등)
• 기술 문서, API 가이드

방법 1: 온라인 뷰어 (설치 불필요, 가장 빠름)

설치 없이 지금 당장 보려면 온라인 마크다운 뷰어를 씁니다.

사용 방법은 단순합니다.

1. 위 링크에 접속합니다.
2. .md 파일을 에디터 영역에 드래그&드롭하거나 파일 업로드 버튼을 클릭합니다.
3. 오른쪽 미리보기 패널에서 GitHub처럼 렌더링된 결과를 바로 확인합니다.

코드 블록은 100개 이상의 언어 하이라이팅이 적용되고, 제목(#, ##)이 있으면 목차(TOC)도 자동으로 생성됩니다. 마크다운을 직접 입력하거나 붙여넣어도 됩니다.

개인정보 걱정 없음: 모든 처리가 브라우저 안에서 이루어집니다. 파일이 서버로 전송되지 않습니다.

방법 2: VS Code (로컬, 무료)

개발 작업을 자주 한다면 VS Code가 가장 편합니다. 설치 한 번으로 MD 파일을 에디터와 미리보기로 동시에 볼 수 있습니다.

1. VS Code 공식 사이트에서 다운로드 후 설치
2. MD 파일을 VS Code로 열기
3. 우측 상단의 미리보기 아이콘(돋보기 모양) 클릭, 또는 Ctrl+Shift+V / Cmd+Shift+V

에디터 왼쪽에 마크다운 원본, 오른쪽에 렌더링 결과가 나란히 표시됩니다. 파일을 편집하면 미리보기가 실시간으로 업데이트됩니다.

장점: 오프라인 사용 가능, 파일 편집 가능
단점: 설치 필요, 처음 실행 시 시간 소요

방법 3: 메모장·텍스트 편집기 (원시 텍스트)

렌더링 없이 마크다운 원본 그대로 봐야 할 때는 메모장(Windows) 또는 TextEdit(Mac)으로 충분합니다.

• Windows: .md 파일 우클릭 → 연결 프로그램 → 메모장
• Mac: .md 파일 우클릭 → 다음으로 열기 → TextEdit

#, **, - 같은 기호가 그대로 보이지만, 내용 자체를 텍스트로 확인하는 데는 문제없습니다. 기호가 불편하다면 방법 1이나 2를 권장합니다.

방법 4: GitHub 웹 (원격 파일)

GitHub 저장소에 있는 MD 파일은 별도 프로그램 없이 GitHub 웹에서 바로 렌더링됩니다. 저장소 페이지의 README.md는 자동으로 표시되고, 다른 MD 파일은 클릭하면 미리보기 탭으로 볼 수 있습니다.

단, 로컬에 저장된 파일이라면 GitHub에 올리지 않는 이상 이 방법은 쓸 수 없습니다.

상황별 추천

MD 파일이 낯설어 보이지만 한 번 렌더링된 결과를 보면 읽기 편한 문서입니다. 설치가 번거롭다면 MD 파일 뷰어에 파일을 드래그하는 것이 가장 빠릅니다.