md-viewer는 Claude Code를 사용하여 문서를 생성하는 개발자를 위해 특별히 제작된 경량 마크다운 뷰어입니다. 이 도구는 Claude가 마크다운 파일을 수정할 때 자동으로 업데이트되는 라이브 리로딩 기능을 제공하여 터미널과 편집기 창 사이를 전환할 필요가 없습니다.

주요 기능

이 도구는 AI 생성 문서 작업 시 발생하는 특정 문제점을 해결합니다:

• 기본 라이브 리로드: Claude가 파일을 업데이트하면, 뷰어가 수동 새로고침 없이 자동으로 다시 렌더링됩니다
• 독립적인 파일 감시: VS Code 미리보기와 달리, md-viewer는 파일이 편집기에서 열려 있을 필요 없이 독립적으로 파일을 감시합니다
• 파일 탐색기 사이드바: 뷰어를 떠나지 않고 문서 파일 사이를 탐색할 수 있습니다
• Mermaid 다이어그램 지원: Claude가 마크다운에서 아키텍처 다이어그램을 생성할 때 기본적으로 렌더링합니다
• 탭 인터페이스: 여러 프로젝트에 걸쳐 여러 문서를 동시에 열 수 있습니다
• 경량 풋프린트: 약 35MB, libc만 연결하며, 즉시 열립니다

설치 옵션

이 도구는 여러 패키지 관리자를 통해 사용할 수 있습니다:

# AUR (Arch 기반)
yay -S md-viewer-git

Snap
sudo snap install md-viewer
Cargo (Rust)
cargo install md-viewer

사용법

기본 사용법은 간단합니다:

• 두 번째 모니터나 터미널 옆에 타일링하여 md-viewer를 엽니다
• 프로젝트의 CLAUDE.md 파일이나 docs/ 폴더를 가리킵니다
• md-viewer path/to/file.md를 사용하거나 파일을 드래그 앤 드롭합니다
• "폴더 열기"가 필요하지 않습니다 - 개별 파일로 작동합니다

이 도구는 Rust와 egui로 구축되었으며, 현재 Linux만 지원합니다(X11 및 Wayland 모두). AI 지원 개발을 위한 읽기 전용 동반자 역할을 하며, 작업일 내내 터미널 세션 옆에 열어둘 수 있도록 설계되었습니다.