MD QuickLook는 macOS Finder에서 .md 파일을 선택하고 스페이스바를 누르면 별도 앱을 열지 않고 문서를 미리 볼 수 있는 오픈소스 Quick Look 확장 프로그램이다. 제작자는 Rust 코어와 macOS 기본 텍스트 시스템을 사용해 웹 엔진 없이 렌더링하며, 앱은 MIT 라이선스로 배포한다.
GitHub Flavored Markdown의 표와 작업 목록, 각주, 경고 블록, 수식, Mermaid 다이어그램과 220개 언어의 코드 하이라이팅을 지원한다. 시스템의 밝은 모드와 어두운 모드를 따르고, 파일 옆에 있는 이미지와 Finder 썸네일도 표시한다. 외부 이미지는 기본적으로 설명만 보여주며, 앱에서 원격 이미지 로드를 켤 수 있다. 네트워크를 사용하는 업데이트 확인은 앱에서만 이뤄지고 Quick Look 확장 프로그램은 네트워크 요청을 하지 않는다고 설명한다.
제작자가 공개한 측정치에 따르면 일반적인 README는 요청 후 화면 표시까지 네이티브 방식에서 약 30ms, 선택 가능한 WebKit 방식에서 약 200ms가 걸린다. 900KB 변경 기록의 첫 화면은 각각 약 60ms와 300ms다. 이는 제작자가 제시한 수치다. 긴 문서는 첫 화면을 먼저 표시하고 나머지를 백그라운드에서 배치한다고 한다. 수식 지원 범위와 Mermaid 다이어그램 예시도 확인할 수 있다. Mermaid 렌더러는 아직 초기 단계라 일부 레이아웃이 mermaid.js와 다를 수 있으며, 간트 차트 날짜와 기간별 이벤트가 여러 개인 타임라인은 알려진 미지원 항목이다. 그릴 수 없는 다이어그램은 원문으로 표시된다.
설치는 Homebrew를 이용하거나 저장소의 설치 스크립트를 실행하면 된다.
brew install --cask armamut/tap/md-quicklook
curl -fsSL https://raw.githubusercontent.com/armamut/md-quicklook/main/scripts/install.sh | bash
수동 설치를 선택하면 Releases에서 압축 파일을 내려받아 앱을 /Applications로 옮긴 뒤 한 번 실행한다. 앱은 공증되지 않았으므로 격리 속성을 먼저 제거해야 한다.
xattr -dr com.apple.quarantine "/Applications/MD QuickLook.app"
소스에서 설치하려면 Rust와 Xcode Command Line Tools가 필요하며, 전체 Xcode는 필요하지 않다.
git clone https://github.com/armamut/md-quicklook.git
cd md-quicklook
make install
앱을 처음 열면 확장 프로그램이 등록된다. 미리보기가 나타나지 않으면 시스템 설정의 일반 ▸ 로그인 항목 및 확장 프로그램 ▸ Quick Look에서 MD QuickLook가 활성화됐는지 확인하고, 앱에서 Quick Look 재설정을 누르면 된다. 업데이트는 앱에서 확인하고 설치할 수 있으며, 자동 확인은 기본적으로 켜져 있어 앱을 열 때 하루 한 번 확인한다. 제거하려면 make uninstall을 실행하거나 앱을 휴지통으로 옮긴다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요