md 파일 열기: README.md 보기 좋게 읽는 마크다운 뷰어 3가지
md 파일은 메모장 같은 텍스트 편집기로 바로 열 수 있습니다. 다만 그렇게 열면 #, *, - 같은 기호가 그대로 보여서 읽기 불편합니다. 제목과 목록, 표가 서식대로 보이게 하려면 마크다운 뷰어가 필요한데, 무료로 쓰려면 Visual Studio Code, 문서처럼 깔끔하게 읽으려면 Typora, 메모를 계속 쌓아 둘 생각이라면 Obsidian을 쓰면 됩니다.
이 글은 개발자가 아닌 사람을 기준으로 썼습니다. 프로그램을 받았더니 README.md가 들어 있다거나, 누군가 .md 파일을 보내 준 경우에 어떻게 여는지 순서대로 설명합니다.
md 확장자는 어떤 파일인가요
.md는 마크다운(Markdown) 문서의 확장자입니다. 마크다운은 간단한 기호로 서식을 표시하는 텍스트 형식입니다. 예를 들어 줄 앞에 #을 붙이면 제목, -를 붙이면 목록, 단어를 **로 감싸면 굵은 글씨가 됩니다.
내용은 일반 텍스트라서 어떤 운영체제에서든 열립니다. 서식은 마크다운을 해석하는 프로그램이 입혀 줍니다. 그래서 같은 파일도 메모장에서는 기호가 섞인 글로 보이고, 뷰어에서는 정리된 문서로 보입니다.
가장 흔히 보는 md 파일은 README.md입니다. 오픈소스 프로그램이나 압축 파일 안에 들어 있는 설명서로, 설치 방법이나 사용법, 주의 사항이 적혀 있습니다. 프로그램을 쓰기 전에 한 번 읽어 보는 게 좋습니다.
설치 없이 바로 읽는 방법
한두 번만 읽을 거라면 프로그램을 새로 깔지 않아도 됩니다.
- 메모장이나 텍스트 편집기로 열기: 파일을 마우스 오른쪽 버튼으로 누르고 연결 프로그램에서 메모장(Windows)이나 텍스트 편집기(Mac)를 고릅니다. 기호가 섞여 보이지만 내용은 모두 읽을 수 있습니다.
- GitHub 페이지에서 읽기: README.md를 GitHub 저장소에서 받았다면 저장소 첫 화면 아래쪽에 README 내용이 서식대로 표시됩니다. 파일을 따로 받지 않고 브라우저에서 읽으면 됩니다.
- 이미 설치된 편집기 활용: VS Code 같은 코드 편집기가 이미 있다면 아래 방법으로 미리보기만 켜면 됩니다.
표나 코드 블록이 많은 README는 텍스트 그대로 읽으면 알아보기 어렵습니다. 이럴 때는 아래 뷰어 중 하나를 쓰는 편이 낫습니다.
Visual Studio Code로 md 파일 열기
Visual Studio Code는 Microsoft가 만든 코드 편집기입니다. 무료로 쓸 수 있고 Windows, Mac, Linux를 모두 지원합니다. 마크다운 미리보기가 기본으로 들어 있어서 확장 프로그램을 따로 설치하지 않아도 됩니다.
- 공식 홈페이지에서 운영체제에 맞는 설치 파일을 받아 설치합니다.
- VS Code를 실행하고 md 파일을 창에 끌어다 놓습니다. 파일 메뉴의 열기로 골라도 됩니다.
- Windows는
Ctrl + Shift + V, Mac은Cmd + Shift + V를 누르면 미리보기 탭이 열립니다. - 원문과 미리보기를 나란히 보려면
Ctrl + K를 누른 뒤V를 누릅니다(Mac은Cmd + K후V).
화면 오른쪽 위의 미리보기 아이콘을 눌러도 같은 화면이 열립니다. 메뉴 위치는 버전에 따라 조금 다를 수 있습니다.
장점은 무료이고 README에 자주 나오는 코드 블록이 잘 보인다는 점입니다. 대신 처음 실행하면 메뉴가 많아서 문서만 읽으려는 사람에게는 복잡하게 느껴질 수 있습니다.
Typora: 워드처럼 깔끔하게 읽고 쓰기
Typora는 마크다운을 입력하면 그 자리에서 바로 서식으로 바뀌는 편집기입니다. 원문 창과 미리보기 창이 나뉘지 않고, 워드 문서를 여는 것처럼 정리된 화면만 보입니다. 기호를 몰라도 읽는 데 문제가 없어서 비개발자에게 가장 익숙한 방식입니다.
- Typora 공식 홈페이지에서 운영체제에 맞는 버전을 받습니다. Windows, Mac, Linux 버전이 있습니다.
- 설치 후 md 파일을 더블클릭하거나 Typora 창에 끌어다 놓습니다.
- 제목, 목록, 표, 이미지가 서식대로 표시됩니다. 원문 기호를 보고 싶을 때는 소스 코드 모드로 바꾸면 됩니다.
PDF나 HTML로 내보내는 기능이 있어서, 받은 README를 인쇄하거나 다른 사람에게 보기 좋게 전달할 때 편합니다. 라이선스 정책(체험 기간, 구매 조건)은 바뀔 수 있으니 공식 사이트에서 최신 정보를 확인하세요.
Obsidian: md 파일을 모아 두고 관리하기
Obsidian은 마크다운 파일을 기반으로 하는 노트 앱입니다. 문서끼리 링크로 연결하고 검색할 수 있어서, md 파일을 계속 쌓아 두는 사람에게 맞습니다. 개인 사용은 무료이고 Windows, Mac, Linux와 모바일 앱이 있습니다.
- Obsidian 공식 홈페이지에서 설치 파일을 받습니다.
- 처음 실행하면 보관함(Vault)을 만들거나 기존 폴더를 보관함으로 열라고 나옵니다. md 파일이 들어 있는 폴더를 고릅니다.
- 왼쪽 파일 목록에서 문서를 누르면 내용이 열립니다. 읽기 모드로 바꾸면 서식만 보입니다.
Obsidian은 폴더 단위로 작동합니다. README 파일 하나만 잠깐 보려는 경우에는 보관함을 만드는 과정이 번거로울 수 있습니다. 반대로 회의록, 공부 노트처럼 md 파일이 계속 늘어나는 경우라면 셋 중 가장 쓸모가 큽니다. 파일이 내 컴퓨터 폴더에 일반 md 형식으로 저장되므로 나중에 다른 프로그램으로 옮기기도 쉽습니다.
세 가지 마크다운 뷰어 비교와 선택 기준
| 항목 | Visual Studio Code | Typora | Obsidian |
|---|---|---|---|
| 보는 방식 | 원문과 미리보기를 나눠서 표시 | 서식이 적용된 화면 하나 | 편집 모드와 읽기 모드 전환 |
| 파일 여는 방법 | 파일 하나씩 바로 열기 | 파일 하나씩 바로 열기 | 폴더(보관함) 단위로 열기 |
| 비용 | 무료 | 공식 사이트에서 확인 | 개인 사용 무료 |
| 잘 맞는 사람 | 코드가 섞인 README를 자주 보는 사람 | 문서를 깔끔하게 읽고 PDF로 내보내려는 사람 | md 노트를 계속 모으고 연결하려는 사람 |
| 진입 난이도 | 메뉴가 많아 처음엔 복잡함 | 가장 쉬움 | 보관함 개념에 익숙해져야 함 |
정리하면 이렇습니다. 프로그램에 들어 있는 README를 가끔 읽는 정도라면 무료인 VS Code 하나로 충분합니다. 기호 없이 문서처럼 보는 게 가장 중요하다면 Typora가 편합니다. 직접 마크다운으로 메모를 쓰기 시작할 생각이라면 Obsidian을 고르는 게 좋습니다.
자주 묻는 질문
md 파일을 더블클릭하면 항상 특정 프로그램으로 열리게 할 수 있나요?
됩니다. Windows에서는 md 파일을 마우스 오른쪽 버튼으로 누르고 연결 프로그램에서 다른 앱을 고른 뒤 항상 이 앱 사용을 선택합니다. Mac에서는 파일의 정보 가져오기 창에서 다음으로 열기 항목의 앱을 바꾸고 모두 변경을 누릅니다.
md 파일을 한글(HWP)이나 워드로 열 수 있나요?
텍스트로는 열리지만 마크다운 서식은 적용되지 않습니다. 워드 문서로 옮기고 싶다면 Typora에서 서식이 보이는 상태로 열고 내보내기 기능을 쓰는 편이 수월합니다.
README.md를 열었는데 이미지가 안 보입니다.
README 속 이미지는 보통 별도 파일이나 인터넷 주소를 가리킵니다. 이미지 파일이 같은 폴더에 없거나 인터넷에 연결되어 있지 않으면 표시되지 않습니다. 압축 파일에서 README만 따로 꺼냈다면 폴더 전체를 푼 뒤 다시 열어 보세요.
휴대폰에서도 md 파일을 볼 수 있나요?
Obsidian은 모바일 앱이 있어서 휴대폰에서도 md 파일을 열 수 있습니다. 파일을 휴대폰의 보관함 폴더로 옮겨야 목록에 나타납니다.
정리
md 파일은 텍스트 파일이라 메모장으로도 열리지만, 서식대로 읽으려면 마크다운 뷰어가 필요합니다. 가끔 README를 읽는 정도라면 무료인 Visual Studio Code의 미리보기(Ctrl + Shift + V)로 충분합니다. 기호 없이 문서처럼 읽고 싶다면 Typora, md 파일을 노트로 쌓아 갈 생각이라면 Obsidian이 맞습니다. 자주 쓰는 뷰어를 기본 연결 프로그램으로 정해 두면 이후로는 더블클릭만으로 열 수 있습니다.