마크다운 뷰어: MD 파일을 여는 방법

.md 파일은 Markdown 문법으로 작성한 텍스트 문서입니다. 메모장에서는 내용을 읽을 수 있지만 제목 앞의 #나 굵게 표시하는 **가 그대로 보입니다. 읽기 편한 문서를 원하면 마크다운 뷰어로 서식을 표시하세요.

설치 없이 브라우저에서 열기

mdview.io를 엽니다.
Open md file을 눌러 컴퓨터의 .md 파일을 선택합니다.
제목, 목록, 표, 코드가 표시되는지 확인합니다.
복사한 내용이 있다면 Paste Markdown에 붙여 넣고 View Markdown을 누릅니다.

파일을 읽기 위해 확장자를 바꿀 필요는 없습니다. .md를 .txt로 바꾸어도 내용이 다른 형식으로 변환되지는 않습니다.

간단한 예제로 확인하기

# 프로젝트 메모

이번 주에 **두 가지**를 확인합니다.

- 일정
- 담당자

| 작업 | 상태 |
| --- | --- |
| 초안 | 검토 중 |

위 내용을 붙여 넣으면 큰 제목, 굵은 글씨, 목록, 표를 볼 수 있습니다. 표시 결과를 확인한 뒤에도 원본 Markdown은 보관하세요. 다른 편집기에서 수정하거나 버전을 관리할 때 필요합니다.

뷰어와 편집기는 어떻게 다른가요?

뷰어는 이미 작성한 문서를 읽는 데 적합합니다. 편집기는 Markdown 소스를 수정하는 도구입니다. 소스와 미리보기를 함께 보여 주는 앱도 있지만, 모든 뷰어가 편집 기능을 제공하는 것은 아닙니다.

README를 검토한다면 설치 명령과 링크도 직접 확인하세요. 문서가 보기 좋게 표시된다는 사실만으로 명령이나 설명이 정확하다고 판단할 수는 없습니다.

이미지가 보이지 않을 때

![그림](./images/example.png)는 별도의 이미지 파일을 가리킵니다. MD 파일만 열었거나 다른 사람에게 전달했다면 그 이미지에 접근할 수 없을 수 있습니다. 파일 위치와 상대 경로를 먼저 확인하고, 공유할 때는 받는 사람도 접근 가능한 이미지 주소를 사용하세요.

이미지와 상대 링크 설명（영어）에서 경로가 어떻게 해석되는지 확인할 수 있습니다.

Mermaid가 그림 대신 코드로 보일 때

코드 블록의 언어가 mermaid인지 확인하세요. 일반 Markdown 지원과 Mermaid 지원은 다릅니다. 지원하는 앱에서도 잘못된 문법은 오류를 일으킬 수 있으므로 작은 예제부터 테스트하는 것이 좋습니다.

보기만 하는 것과 웹에 공개하는 것도 다릅니다. 공유 링크를 만들기 전에는 문서에 비밀번호, API 키, 개인정보가 없는지 확인하세요. 링크를 공개하지 않고 읽는 방법과 공개 범위를 설정하는 방법을 구분해야 합니다.

지금 파일을 읽으려면 mdview.io에서 열어 보세요. 링크로 전달하는 과정은 Markdown 공유 안내（영어）를 참고하세요.