마크다운 파일은 일반 텍스트입니다. 메모장이나 코드 편집기로 열면 굵은 글씨, 제목, 표가 있어야 할 자리에 별표, 샵 기호, 파이프가 그대로 보입니다. 마크다운 뷰어는 이 텍스트를 GitHub가 README를 보여 주듯 읽기 좋은 페이지로 바꿔 줍니다.
Markdown Preview Editor는 무료 온라인 마크다운 뷰어로도 쓸 수 있습니다. 브라우저에서 파일을 열고 미리 보기 모드로 바꾸면 끝입니다. 설치할 것도, 계정도 없고, 파일은 내 컴퓨터에 그대로 남습니다.
.md 파일이란?
.md(가끔 .markdown)로 끝나는 파일은 간단한 서식 문법인 마크다운으로 쓴 텍스트 문서입니다. # 제목은 제목이 되고, **굵게**는 굵게가 되며, 파이프 몇 개로 표를 만듭니다. .md 파일은 GitHub의 README, 기술 문서, Obsidian 메모, AI 채팅 도우미나 지식 베이스에서 내보낸 파일 등 어디에나 있습니다.
어떤 텍스트 편집기로도 열 수 있지만, 서식까지 보여 주는 것은 마크다운 뷰어뿐입니다. 문법 자체를 익히고 싶다면 마크다운 문법 정리를 곁에 두세요.
온라인에서 .md 파일 여는 방법
- 에디터를 엽니다. 온라인 에디터로 이동하면 1초 만에 열립니다.
- 파일을 추가합니다.
.md파일을 에디터 영역에 끌어 놓거나 열기를 클릭합니다(Ctrl+O, Mac에서는⌘O). 여러 파일이나 폴더 전체도 한 번에 열 수 있으며, 문서마다 별도의 탭이 열립니다. - 미리 보기 모드로 바꿉니다. 헤더의 미리 보기를 클릭하면 문서를 화면 가득 읽을 수 있습니다. 편집도 하려면 분할을 선택해 원문과 결과를 나란히 보세요.
- 필요하면 저장하거나 내보냅니다.
.md로 저장하거나, 독립 실행형 HTML 페이지로 내보내거나, PDF로 인쇄할 수 있습니다.
뷰어는 .md, .markdown, .mdown, .mkd, .mkdn, .mdx, .txt 파일을 엽니다.
뷰어가 보여 주는 것
뷰어는 GitHub-Flavored Markdown을 렌더링하므로 문서가 GitHub에서 보는 모습과 거의 같습니다.
- 제목, 목록, 링크, 인용문, 가로줄
- 열 정렬이 되는 표와 체크박스가 있는 할 일 목록
- 구문 강조가 적용된 코드 블록
- 각주와 GitHub 스타일 알림 상자(
[!NOTE],[!TIP],[!WARNING]) - LaTeX로 쓴 수식
- 순서도, 시퀀스 다이어그램 등 Mermaid 다이어그램
열려 있는 .md 파일끼리의 링크를 누르면 해당 탭으로 전환되므로, 문서 폴더를 작은 웹사이트처럼 읽을 수 있습니다.
이미지와 링크
images/diagram.png 같은 상대 경로 이미지는 폴더 전체를 열거나 이미지를 문서와 함께 끌어 놓으면 표시됩니다. 에디터가 끌어 놓은 파일을 기준으로 경로를 찾습니다.
인터넷에 있는 이미지, 오디오, 동영상은 기본적으로 불러오지 않으며, 링크도 허용하기 전까지는 비활성 상태입니다. 출처를 모르는 파일을 열었을 때 다른 서버에 접속하지 않도록 일부러 그렇게 만들었습니다. 보호 패널에서 클릭 한 번으로 외부 이미지, 미디어, 링크를 허용할 수 있습니다.
파일은 내 기기에 남습니다
많은 온라인 뷰어는 파일을 렌더링하려고 서버에 업로드합니다. 여기서는 브라우저가 파일을 읽어 탭 안에서 바로 렌더링하며, 파일은 어디에도 전송되지 않습니다. 설정에서 이 브라우저에 문서 기억하기를 켜지 않으면 문서는 탭이 열려 있는 동안에만 유지됩니다.
그래서 사내 문서, 초안, 계약서처럼 업로드하고 싶지 않은 파일을 보기에 알맞습니다.
제한 사항
- 웹 페이지이므로 Windows나 macOS에서
.md파일을 더블클릭할 때 여는 기본 앱으로 지정할 수 없습니다. 파일을 페이지에 끌어 놓거나 열기를 사용하세요. - 파일은 내 기기에서만 열 수 있습니다. GitHub나 다른 웹사이트에 있는 마크다운 파일을 보려면 먼저 내려받거나 텍스트를 에디터에 붙여 넣으세요.
- 다이어그램이 많은 긴 문서는 다이어그램마다 브라우저에서 그리기 때문에 렌더링에 조금 더 시간이 걸립니다.
실시간 미리 보기가 있는 분할 에디터가 필요하다면 마크다운을 온라인으로 미리 보는 방법을 읽어 보거나 마크다운 에디터 홈으로 돌아가세요.
자주 묻는 질문
.md 파일은 어떻게 여나요?
온라인 마크다운 뷰어를 열고 .md 파일을 끌어 놓거나 열기를 클릭하세요. 미리 보기로 바꾸면 서식이 적용된 문서를 읽을 수 있습니다. 설치나 계정은 필요 없습니다.
파일이 서버에 업로드되나요?
아니요. 파일은 브라우저에서 읽고 렌더링합니다. 내 기기를 떠나지 않으며, 이 브라우저에 문서 기억하기를 켜지 않는 한 저장되지도 않습니다.
이미지까지 함께 볼 수 있나요?
네. 폴더 전체를 열거나 이미지를 .md 파일과 함께 끌어 놓으세요. 상대 경로 이미지는 끌어 놓은 파일을 기준으로 찾습니다.
휴대폰에서도 되나요?
네. 휴대폰에서는 열기로 파일을 고른 뒤 미리 보기 모드로 바꾸세요. 레이아웃이 작은 화면에 맞게 바뀝니다.
본 파일을 다른 형식으로 바꿀 수 있나요?
네. 독립 실행형 HTML 파일로 내보내거나 PDF로 인쇄할 수 있습니다. 마크다운 PDF 변환을 참고하세요.
