Marky – AI 에이전트 코딩에 최적화된 경량 Markdown 뷰어

Who Should Read

AI 에이전트(Claude, Cursor 등)를 활용해 코딩하면서 생성된 계획 문서, README, 노트 등을 빠르게 확인하고 싶은 macOS 개발자. 특히 에이전트가 대량의 Markdown 파일을 쏟아낼 때 이를 편리하게 관리하고 싶은 사람.

Core Mechanics

• Marky는 터미널에서 `marky FILENAME` 또는 `marky FOLDER` 명령어 하나로 Markdown 파일이나 폴더를 즉시 렌더링해주는 macOS 전용 데스크탑 앱이다.
• 라이브 리로드 기능을 지원해서 Claude나 에디터가 파일을 수정하면 별도 새로고침 없이 뷰어 화면이 자동으로 업데이트된다. AI가 문서를 작성하는 동안 실시간으로 내용을 확인할 수 있다.
• 폴더를 워크스페이스로 등록하면 Obsidian처럼 사이드바에 파일 목록이 나타나고, 앱 재실행 시에도 자동으로 복원된다.
• Cmd+K 커맨드 팔레트로 등록된 모든 폴더의 파일을 퍼지 검색(fuzzy search)할 수 있으며, 내부적으로 nucleo 라이브러리를 사용한다.
• 코드 블록은 Shiki(VS Code와 동일한 문법 강조 엔진)로 렌더링되고, 수식은 KaTeX, 다이어그램은 Mermaid로 SVG 렌더링된다. 테이블, 체크박스, 각주 등 GFM(GitHub Flavored Markdown) 전체를 지원한다.
• HTML 렌더링은 DOMPurify를 통해 sanitize 처리되므로 신뢰할 수 없는 Markdown 파일도 안전하게 열 수 있다.
• 기술 스택은 Tauri v2(Rust 기반 데스크탑 앱 프레임워크) + React + markdown-it이며, Homebrew로 설치하거나 소스에서 직접 빌드할 수 있다.

Evidence

• 'native'라는 표현이 오해를 줄 수 있다는 지적이 있었다. Tauri가 시스템 WebView를 사용하긴 하지만 결국 WebView 기반이라 'JavaScript native'라고 부르는 건 과장이라는 의견이 나왔다.
• 비슷한 도구를 직접 만들었다는 사람이 여러 명 등장했다. vantageapp.dev, sdocs.dev, seams, hyprmark, mdreader 등 유사 프로젝트가 댓글에 다수 공유됐는데, AI 에이전트 개발 붐으로 이 문제를 해결하려는 사람이 동시다발적으로 늘어났다는 걸 보여준다.
• 'Obsidian이랑 다를 게 뭐가 있냐'는 질문이 나왔다. Obsidian도 폴더 뷰, Markdown 렌더링을 지원하는데 차별점이 불분명하다는 지적이다. 아직 명확한 반론은 없었고 해당 댓글은 논의로 이어지지 않았다.
• 'VS Code + Markdown 미리보기도 거의 같은 기능 아닌가'라는 의견도 있었다. 다만 이 댓글에서 실제로 원하는 건 git 연동과 에이전트가 수정한 부분을 하이라이트해서 보여주는 기능이라는 구체적인 니즈가 함께 제시됐다.
• 텍스트 크기 조절이 안 된다는 UX 불편 사항이 제기됐다. 사이드바 컬럼 너비 조절도 안 된다는 피드백과 함께, 기본 크기가 작아 시력에 부담이 된다는 실사용 의견이 있었다.

How to Apply

• Claude나 Cursor 같은 AI 에이전트에게 계획 문서나 스펙 파일을 Markdown으로 작성하게 한 뒤, 별도 터미널에서 `marky ./plans/` 명령어로 해당 폴더를 열어두면 에이전트가 파일을 업데이트하는 즉시 라이브로 내용을 확인할 수 있다.
• 에이전트가 대량의 Markdown 파일을 생성하는 프로젝트에서 `marky .` 처럼 프로젝트 루트를 열고 Cmd+K 퍼지 검색으로 원하는 파일을 빠르게 찾아볼 수 있다. 파일이 75개 이상 생성되더라도 빠르게 탐색 가능하다.
• Mermaid 다이어그램과 KaTeX 수식 렌더링을 지원하므로, AI에게 시스템 아키텍처나 플로우를 Mermaid 코드 블록으로 작성하도록 프롬프트하면 Marky에서 즉시 시각화해서 확인할 수 있다.
• 신뢰할 수 없는 소스에서 받은 Markdown 파일도 DOMPurify sanitize가 적용되므로, 외부에서 받은 문서를 확인할 때 XSS 위험 없이 안전하게 렌더링해서 볼 수 있다.

Code Example

# 설치 (Homebrew)
brew install marky

# 단일 파일 열기
marky README.md

# 폴더 전체를 워크스페이스로 열기
marky ./docs/

# 현재 디렉토리 열기
marky .

Terminology

Related Resources

• https://github.com/GRVYDEV/marky
• https://vantageapp.dev/
• https://github.com/mschulkind-oss/swarf/
• https://sdocs.dev
• https://news.ycombinator.com/item?id=47777633
• https://github.com/yakkomajuri/seams
• https://github.com/robinduckett/hyprmark
• https://github.com/3rd/mdreader
• https://zerodevx.github.io/zero-md/