Hacker News 2026.04.17 31

Marky: AI 코딩 에이전트 시대를 위한 초경량 마크다운 뷰어

AI가 코드를 짜는 시대, 문서 읽는 도구도 달라져야 할까요

Claude Code, Cursor, Cline 같은 에이전트형 코딩 도구를 쓰다 보면 새로운 습관이 하나 생깁니다. 바로 .md 파일이 엄청나게 늘어나는 거요. 작업 계획서(plan.md), 아키텍처 메모(architecture.md), 에이전트에게 주는 지시사항(AGENTS.md, CLAUDE.md), 작업 로그(tasks.md)까지. AI가 중간 결과물을 마크다운으로 저장하는 일이 많아지면서, 이 파일들을 빠르게 훑어보는 게 일상이 됐어요.

문제는 기존 마크다운 뷰어들이 이 용도에 딱 맞지 않는다는 거예요. Typora나 Obsidian 같은 도구는 노트 앱으로 설계됐고, Visual Studio Code의 프리뷰는 파일 탐색이 불편하고, 웹 기반 툴은 로컬 파일을 편하게 못 읽습니다. 이 간극을 노린 오픈소스 프로젝트가 Marky예요.

Marky가 해결하려는 구체적 문제

Marky는 GitHub의 GRVYDEV 개발자가 만든 초경량 마크다운 뷰어로, 한 문장으로 요약하면 "에이전트 코딩 워크플로우를 위한 파일 브라우저 + 마크다운 프리뷰"예요. 핵심 특징은 몇 가지로 정리됩니다.

먼저 로컬 파일 시스템 중심이에요. 폴더를 열면 하위의 모든 .md 파일을 트리 구조로 보여주고, 클릭 한 번으로 바로 렌더링된 결과를 볼 수 있어요. 둘째, 파일 변경 감지가 기본 기능이에요. AI 에이전트가 백그라운드에서 파일을 수정하면 뷰어가 자동으로 갱신됩니다. 이게 생각보다 편해요. Claude Code가 plan.md를 수정하는 걸 실시간으로 따라가며 볼 수 있거든요.

셋째, 가볍다는 점. Electron으로 만든 수백 MB짜리 데스크톱 앱이 아니라 훨씬 작은 풋프린트로 돌아가는 걸 목표로 하고 있어요. 개발자 머신 리소스를 많이 쓰는 앱은 그 자체로 피로감이 되니까요.

에이전트 코딩 워크플로우라는 맥락

이 프로젝트의 가치를 제대로 이해하려면 최근 코딩 도구 트렌드를 짚어봐야 해요. 에이전트 코딩이라는 말이 이제 자연스러워졌는데, 이게 뭐냐면 AI가 단순히 코드 한 줄을 자동완성해주는 게 아니라, "이 기능 구현해줘"라고 하면 스스로 파일을 여러 개 만들고 수정하고 테스트까지 돌리는 방식이에요.

이 방식의 특징은 AI가 마크다운 파일을 인간과의 소통 매개체로 적극 활용한다는 거예요. 계획을 세우면 plan.md를 만들고, 진행 상황을 todo.md에 체크하고, 막히면 questions.md에 질문을 쓰죠. 개발자는 코드 에디터에서 코드를 보는 동시에, 이 마크다운 파일들로 AI의 생각을 따라가야 합니다.

여기서 전용 뷰어의 필요성이 생겨요. VS Code 탭을 이미 너무 많이 열어둔 상태에서 .md 파일까지 섞이면 정신이 없거든요. 모니터 한쪽에 Marky 같은 가벼운 뷰어를 띄워두고 AI의 작업 진행을 거기서 따라가는 구성이 훨씬 쾌적합니다.

비슷한 도구들과의 비교

이 영역에는 이미 플레이어들이 있어요. Glance는 CLI로 마크다운을 빠르게 보여주는 도구고, MarkText는 데스크톱 에디터, Logseq와 Obsidian은 개인 지식 관리용입니다. 하지만 이 도구들 중 "에이전트 코딩 특화"를 명시적으로 내세운 건 드물어요.

Marky의 포지셔닝이 흥미로운 건, 이 도구가 단일 목적을 향해 최적화되어 있다는 점이에요. 복잡한 플러그인 시스템, 양방향 링크, 그래프 뷰 같은 기능을 다 빼고 "폴더 열고, 파일 보고, 자동 갱신"이라는 세 가지만 잘하겠다는 거죠. 유닉스 철학에 가까운 접근법입니다.

한국 개발자에게 주는 시사점

실용적 관점에서 두 가지 포인트가 있어요. 첫째, 당장 업무에 적용해볼 만하다는 점. 에이전트 코딩을 본격적으로 쓰고 계신 분이라면 한번 설치해서 써볼 가치가 있어요. 특히 여러 프로젝트를 동시에 굴릴 때 각 프로젝트의 plan.md와 CLAUDE.md를 한눈에 보는 게 생각보다 효율적이거든요.

둘째, 작은 툴 만들기의 기회. Marky 같은 프로젝트가 보여주는 건, AI 코딩 에이전트가 보편화되면서 주변 툴체인에 새로운 빈틈이 계속 생긴다는 거예요. 에이전트 작업 로그 검색 도구, 다중 에이전트 조율 대시보드, 프롬프트 히스토리 관리 같은 영역은 아직 표준이 없습니다. 주니어 개발자가 오픈소스 기여로 이름을 알리기에도 좋은 지형이고요.

기여하실 계획이라면 GitHub 리포를 먼저 살펴보세요. 최근 출시된 프로젝트라 아직 이슈와 PR이 많지 않아서 기여 진입장벽이 낮습니다. 한국어 렌더링 테스트 같은 기본적인 기여도 환영받을 가능성이 높아요.