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

관련 논문

• ChatGPT for Google Sheets, 워크북 전체 데이터 유출 취약점 발견

  Google Sheets용 ChatGPT 확장 프로그램이 간접 프롬프트 인젝션 공격에 취약해, 단 하나의 시트에 숨겨진 악성 명령만으로 계정 내 워크북 전체가 외부로 유출될 수 있다는 보안 연구 결과가 공개됐다.

• LinTree: 명시적으로 구조화된 Search History로 LLM 추론 개선하기

  LLM의 추론 트레이스에 부모 포인터(parent pointer)만 추가해도 탐색 성능과 효율이 크게 올라간다.

• Resource-Constrained Visual Agent의 Shared-State Collaboration 실패 모드 진단

  4B~8B 소형 비전 모델에서 공유 메모리(화이트보드) 기반 멀티에이전트 협업이 오히려 성능을 떨어뜨리는 이유를 분석한 연구.

• Open Envelope – AI Agent 팀을 정의하는 오픈 스키마

  여러 AI 에이전트가 팀처럼 협업하는 구조를 벤더 중립적인 오픈 스키마로 선언적으로 정의할 수 있게 해주는 프로젝트로, 멀티 에이전트 오케스트레이션의 표준화를 시도한다.

• LLM 기반 Multi-Agent 시스템의 Temporal & Structural Credit Assignment 통합 Prompt 최적화

  여러 AI 에이전트가 협력할 때 '어느 라운드의 어느 에이전트'가 실패했는지 정확히 짚어내서 그 프롬프트만 고치는 최적화 프레임워크

• Ktx – 데이터 에이전트를 위한 오픈소스 Executable Context Layer

  AI 에이전트가 회사 데이터 웨어하우스를 정확하게 쿼리할 수 있도록 시맨틱 레이어, 메모리, 비즈니스 지식을 자동으로 구축해주는 오픈소스 도구다. 기존 에이전트가 매번 웨어하우스를 재탐색하거나 잘못된 메트릭 로직을 임의로 만들어내는 문제를 해결한다.

• Multi-Agent LLM 시스템으로 취약점 자동 발견 및 재현하기 - FuzzingBrain V2

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/