GitHub 오픈소스 탐험

마크다운(Markdown)은 문서 작성에 있어 유연하고 간편한 형식으로 많은 개발자와 작가들의 사랑을 받아왔습니다. 하지만 마크다운 파일을 읽고 편집할 수 있는 적절한 도구를 찾는 것은 여전히 어려운 과제입니다. 특히 macOS 사용자라면, 복잡한 웹 애플리케이션 대신 간단하고 빠른 로컬 애플리케이션을 선호할 것입니다. 이러한 요구를 충족시키기 위해 개발된 프로젝트가 바로 Markdown Preview입니다. 이 글에서는 Markdown Preview의 주요 기능과 설치 방법, 기본 사용법을 자세히 살펴보겠습니다.

Markdown Preview란?

Markdown Preview는 macOS 환경에서 마크다운(.md) 파일을 빠르고 간편하게 읽고 편집할 수 있는 네이티브 애플리케이션입니다. Electron이나 다른 무거운 웹 기반 솔루션 대신, Swift로 개발된 이 애플리케이션은 성능이 뛰어나고, 직관적인 사용자 인터페이스를 제공합니다. 간단히 말해, Markdown Preview는 마크다운 파일을 보기 좋은 형태로 변환해주는 뷰어입니다.

![Markdown Preview](docs/screenshot-main.png)

주요 특징

Markdown Preview의 주요 기능을 살펴보면 다음과 같습니다:

네이티브 렌더링: WKWebView를 이용해 마크다운을 빠르고 정확하게 렌더링합니다.
편집 모드: 마크다운 파일을 직접 편집할 수 있는 기능이 있어, 서식 도구를 통해 쉽게 스타일을 적용할 수 있습니다.
Mermaid 다이어그램과 수학 방정식: 전문적인 문서 작성에 필요한 다이어그램과 LaTeX 수학 공식을 지원합니다.
문서 개요: 사이드바에 문서의 목차를 표시하여 쉽게 탐색할 수 있습니다.
인스펙터 패널: 파일 메타데이터를 쉽게 확인할 수 있는 사이드 패널을 제공합니다.
문서 검색: 문서 내에서 원하는 내용을 빠르게 검색할 수 있는 기능이 있습니다.
Open With: 기본 편집기에서 바로 열 수 있는 기능을 제공합니다.

이처럼 Markdown Preview는 개발자와 작가 모두에게 유용한 기능들을 갖추고 있습니다.

설치 방법

Markdown Preview는 Homebrew를 통해 간편하게 설치할 수 있습니다. 다음 명령어를 터미널에 입력하세요:

brew install --cask markdown-preview

또는 Releases 페이지에서 최신 버전의 DMG 파일을 다운로드할 수 있습니다.

빠른 시작 가이드

설치가 완료되었다면, 이제 Markdown Preview를 사용해볼 차례입니다. 아래의 단계로 간단히 시작해 보세요:

Markdown Preview를 실행합니다.
.md 파일을 마우스로 드래그하여 아이콘 위에 올려놓습니다. 또는 파일을 더블 클릭하여 Markdown Preview에서 열 수 있습니다.
원하는 내용을 편집할 경우, 상단의 Edit 버튼을 클릭하거나 단축키 ⌘E를 눌러 편집 모드로 전환합니다.
수정이 완료되면 ⌘S를 눌러 저장합니다.

![Edit Mode](docs/screenshot-edit-mode.png)

이제 마크다운 파일을 간편하게 읽고 편집할 수 있습니다!

실무에서의 활용

Markdown Preview는 개인 프로젝트의 문서를 작성하거나, 개발 중인 프로젝트의 README 파일을 편집하는 데 유용하게 사용될 수 있습니다. 예를 들어, GitHub에 올릴 프로젝트 문서를 작성할 때, Markdown Preview를 사용하여 간편하게 내용을 정리하고, 실시간으로 변경 사항을 시각적으로 확인할 수 있습니다.

비슷한 도구와의 비교

마크다운 파일을 관리하는 도구는 다양합니다. 예를 들어, Visual Studio Code와 같은 코드 편집기에서도 마크다운 파일의 미리보기를 지원하지만, Markdown Preview는 더 직관적이고 가벼운 사용 경험을 제공합니다. 또한, Markdown Preview는 LaTeX 수식 및 Mermaid 다이어그램을 직접 지원하여, 복잡한 문서 작업 시 매우 유용합니다.

가벼운 마크다운 뷰어, Markdown Preview는 왜 주목받을까?