마크다운 하나로 문서, 대시보드, 슬라이드까지 - MDV가 그리는 통합 저작 도구의 꿈

마크다운이 좀 더 욕심을 부리기 시작했어요

개발자라면 마크다운 안 써본 사람이 거의 없을 거예요. README도 마크다운이고, 회사 위키도 마크다운이고, 블로그도 마크다운이죠. 문법이 단순해서 금방 익히고, 그냥 텍스트라서 git으로 버전 관리하기도 편해요. 그런데 한 가지 고질적인 아쉬움이 있었거든요. "데이터를 다루는 일" 에는 약하다는 거예요.

예를 들어 프로젝트 진행 상황을 문서화하면서 숫자 차트를 넣고 싶으면, 외부에서 이미지를 만들어 붙이거나, 복잡한 플러그인을 찾거나, 아예 다른 도구(Notion, Jupyter, Tableau 같은 것들)로 갈아타야 했어요. 슬라이드를 만들고 싶으면 Reveal.js 같은 걸 따로 세팅해야 했고요. 최근에 공개된 MDV(Markdown View) 라는 오픈소스 프로젝트는 바로 이 지점을 건드립니다. 마크다운 문법은 그대로 두되, 거기에 데이터 바인딩과 시각화, 그리고 슬라이드 모드까지 한 번에 얹어버린 거죠.

MDV는 정확히 뭘 해주는 건가요

MDV는 자기 자신을 "마크다운의 슈퍼셋(superset)"이라고 부르는데, 이게 무슨 말이냐면요. 기존 마크다운 문법을 그대로 받아들이면서 거기에 기능을 더 얹었다는 뜻이에요. 그래서 일반 .md 파일은 그대로 MDV로 열려요. 대신 특별한 블록 문법 몇 개를 더 지원해서, 그 안에 CSV 같은 데이터를 직접 넣거나 SQL 비슷한 쿼리를 써서 테이블을 만들고, 그걸 바로 차트로 그려버릴 수 있어요.

구조적으로 보면 같은 .md 소스 파일 하나로 세 가지 출력물을 만들 수 있습니다. 첫째는 우리가 흔히 아는 문서 뷰예요. 평범한 아티클처럼 읽히지만, 본문 중간에 실시간 차트나 테이블이 박혀 있어요. 둘째는 대시보드 뷰로, 여러 개의 차트와 지표를 격자 레이아웃으로 배치해 한눈에 볼 수 있게 해줘요. 셋째는 슬라이드 뷰인데, --- 같은 구분자로 섹션을 나누면 발표 자료처럼 한 페이지씩 넘기는 형태로 렌더링돼요. 같은 콘텐츠를 용도에 맞게 세 가지 얼굴로 보여주는 셈이죠.

기존 도구들과 비교하면 어떤 자리인가요

이 영역에는 사실 경쟁자가 꽤 많아요. 데이터 시각화 쪽에서는 Observable의 Observable Framework가 비슷한 철학으로 가고 있고, 노트북 스타일로는 Jupyter와 Quarto가 자리를 잡고 있어요. 슬라이드 쪽은 Marp, Slidev, Reveal.js가 나눠 가지고 있고요. Notion은 데이터베이스 뷰를 문서에 꽂아 넣는 식으로 비슷한 문제를 풀죠.

MDV의 차별점은 "가볍고 로컬 파일 기반" 이라는 점에 있어요. Quarto는 파이썬/R 런타임이 필요하고, Observable Framework는 Node 기반에 빌드 단계가 복잡하죠. Notion은 아예 클라우드 서비스라 데이터가 외부로 나가요. 반면 MDV는 .md 파일 하나와 데이터만 있으면 되고, git으로 관리하기도 자연스러워요. 대신 아직 프로젝트 초기 단계라 생태계나 플러그인, 차트 종류 같은 부분에서는 성숙한 경쟁자들에 비해 부족할 수 있어요. 이 분야는 "얼마나 편하게 쓸 수 있냐"가 결국 승부처라, 앞으로 DX(개발자 경험)를 얼마나 다듬느냐가 관건일 것 같아요.

한국 개발자에겐 어떤 쓸모가 있을까요

실무에서 바로 떠오르는 시나리오가 몇 가지 있어요. 스타트업의 주간 회고 문서를 생각해보면, 지금은 노션에 숫자 박고 링크 걸고 하는데, 이걸 저장소에 커밋되는 마크다운으로 만들면 변경 이력이 고스란히 남아요. 사내 기술 블로그에 벤치마크 결과를 올릴 때도, 그래프를 PNG로 떠서 붙이는 대신 데이터와 함께 코드화해두면 수치가 바뀌어도 문서가 자동으로 갱신돼요. 개발자 컨퍼런스 발표 자료를 만들 때도 Keynote 대신 .md로 작성해서 그대로 슬라이드로 쓸 수 있고, 나중에 블로그 글로 전환하기도 훨씬 쉽죠.

다만 프로덕션에 바로 도입하기엔 아직 이른 느낌이에요. 사이드 프로젝트나 팀 내부 문서로 먼저 써보면서 생태계가 어떻게 성장하는지 지켜보는 게 현실적인 접근이 아닐까 싶어요. 개인적으로는 "글과 데이터가 한 파일 안에 공존한다"는 방향성이 점점 대세가 되는 것 같아서, 이 흐름 자체는 익혀둘 가치가 충분하다고 봐요.

마무리

마크다운이 단순한 텍스트 포맷을 넘어 "데이터와 결합된 문서 플랫폼" 으로 진화하는 흐름을 MDV가 잘 보여주는 것 같아요. 여러분은 지금 문서, 대시보드, 슬라이드를 각각 다른 도구로 만들고 계신가요? 아니면 이미 한 도구로 통합하는 시도를 해보셨나요? 통합의 장점과 단점 중 어떤 쪽이 더 크게 느껴지시는지 댓글로 나눠봐요.