Claude 연구원은 HTML이 Markdown보다 더 쓰기 좋다고 말했습니다.
2026년 5월, Anthropic의 Claude Code 엔지니어링 리드 타리크 시히파르(Thariq Shihipar)가인폭료일장론전을 일으켰다. 그의 제목은 이렇다. "Using Claude Code: The Unreasonable Effectiveness of HTML". 공개된 지 16시간 만에 440만 조회수, 8,200개의 좋아요, 15,700개의 북마크를 기록하며 개발자 커뮤니티를이분했다.
핵심 논지지유일개: Markdown에 익숙해진 개발자들조차, 2026년 현재 AI 에이전트 시대의 출력 포맷으로 HTML이 우월하다는 것이다.
타리크 시히파르는 누구인가
그의 제안을 경멸로 치부하기 어렵게 만드는 배경영이 있다. 타리크 시히파르는 현재 Anthropic에서 Claude Code의 엔지니어링 리드이며, Opus 4.7 모델과 동일한 이름의 에이전트 CLI를 이끌고 있다. Y Combinator W20 배치 스타트업 공동 창업자, MIT Media Lab 출신으로, 단순한 외부 애널리스트가 아닌 Anthropic 내부에서 매일 Claude Code로 Claude Code 자체를 만드는 사람이 직접 밝힌 주장이다.
2026년 3월에는 내부에서 수백 개의 Skills를 기반으로한 Claude Code Skills 가이드를 공개하며 업계참고적문당으로 자리 잡았다. 그의 관점은실험실 실험이 아닌, 매일적생산환경에서 나온 것이다.
다섯 가지 핵심 주장
1. 정보 밀도: Markdown이 할 수 없는 것
Markdown은 단락, 목록, 링크, 코드 블록, 간단한 테이블을 잘 처리한다. 그러나 거기서 끝이다. 다이어그램, 차트, 여백 메모, UI 컴포넌트 상태 등을 표현하려면 ASCII art, 외부 이미지 참조, 또는 Markdown 내부에 HTML 블록 임베딩 같은 우회 방법을 사용해야 한다. 그러면 Markdown의 본래 장점인 이식성이 사라진다.
HTML은 하나의 자체 포함 파일로 렌더링할 수 있다:
• Sticky 헤더가 있는 복잡한 테이블
• SVG 벡터 일러스트레이션
• 스크립트 태그 내 실행 가능한 코드 스니펫
• DOM에 연결된 JavaScript 인터랙션
• Absolute 포지셔닝이나 Canvas의 공간 레이아웃
• Base64 인라인 이미지
• 문서 범위의 스타일시트
시히파어가 보여준 한 장의 스크린샷이시사적이다. Claude Code가 Markdown에서 "색상을 표현하라"는 명령을 받으면 Unicode 문자로 근사치를 표현하려 하는데, 그 창의성도, 동시에 형식의 한계의증상이기도 하다.
2. 100줄 한계: Markdown의 가독성 벽
시히파어의 두 번째 관찰은 통계적이자 개인적이다. 아무도 100줄 이상의 Markdown 파일을 실제로 읽지 않는다 — 그 자신도 포함해서.
문제는 Claude가 Opus 4.7에서 도입된 100만 토큰 컨텍스트 윈도우 때문에, 종종 수백 줄에 달하는 구현 계획과 기술 스펙을 생산한다는 것이다. HTML 문서는 탭, 측면 목차, 접이식 섹션, 반응형 레이아웃으로 내부 내비를 구조화할 수 있다. 데스크톱에서는 8개 섹션을 넘나들고, 휴대전화에서는 문서가 자체 재구성되며, 어떤 경우에도 독자는 텍스트의 undifferentiated wall을 스크롤할 필요가 없다.
2026년 5월 Claude Code 업데이트 — 플러그인 마켓플레이스부터 멀티 워크트리 지원까지 — 는 길고 복잡한 작업을 더 빈번하게 만들었다. 출력 형식은 그 복잡성을 담을 수 있어야 한다.
3. 공유: Markdown의 진정한 병목
Markdown에는 실제 문제가 있다. 브라우저가원생으로 렌더링하지 않는다. 이메일이나 메시지로 공유된 .md 파일은 적절한 편집기, 수동 변환 또는 첨부 파일이 필요하다. 반면 HTML은 모든 브라우저에서 사전 렌더링된 상태로 제공된다.
S3나 기업 CDN에 파일을 업로드하면 동료가 어떤 기기에서든 클릭 한 번으로 열 수 있는 링크가 생성된다. 시히파어가 지적하듯, 형식이 HTML일 때 사양, 보고서, PR 설명을 실제로 읽을 확률이 비선형적니상승한다. 잘 정돈된 기사가 monospace 폰트의 초안보다 완전히 읽히는 논리와 같다.
4. 쌍방향 인터랙션: HTML 플레이그라운드
네 번째 장점은 시히파어가 "쌍방향 인터랙션"이라고 부르는 것이다. HTML은 출력 형식일 뿐 아니라 입력 형식이기도 하다. 몇 줄의 JavaScript로 Claude Code는 애니메이션 매개변수를 변경하는 슬라이더, 버튼의 easing 커브를 조정하는 노브, 현재 UI 상태를 새 Claude 세션에 붙여넣을 프롬프트로 변환하는 버튼이 포함된 문서를 생성할 수 있다.
이 인터랙션은 문서를 읽는 행위를 넘어서, 문서와 대화하는 행위로 전환한다.
5. 정보원으로서의 우위: 다양한 소스의 컨텍스트 변환
Claude Code는 파일시스템, Slack이나 Linear 같은 MCP 서버, Chrome의 Claude 브라우징, git 히스토리 등 다양한 소스에서 컨텍스트를 수집한다. 해당 컨텍스트를 HTML 아티팩트로 변환하면 Markdown 요약을 생산하는 것보다 almost 항상 더 표현력이풍카다.
구체적인 활용 사례 6가지
시히파어는 자신의 주장을 뒷받침하기 위해 20개의 공개 활용 사례를 공유했다.
| 활용 분야 | Markdown의 한계 | HTML의 이점 |
|---|---|---|
| 탐색 및 계획 | 긴 구현 계획은 가독성 부족 | 탭/목차로 구조화 |
| 코드 리뷰 | diff를 텍스트로 읽어야 함 | 시각적 diff + 인터랙티브 코드 |
| 설계 및 프로토타이핑 | 이미지 참조 필요 | 인라인 SVG/Canvas |
| 다이어그램 | ASCII art에 한계 | SVG 벡터 일러스트 |
| 프레젠테이션 | 슬라이드 전환 불가 | 애니메이션 + 인터랙션 |
| 보고서 편집 | 정적 문서 | 동적 필터링 + 정렬 |
커뮤니티의 반발: 무엇이 잘못되었나
모든의론ocaleft료일장열뇌적쟁론이다. 주요 반박 의견은 다음과 같다.
"문법이 복잡하다" — Markdown의 장점이 바로 간결함이었다. HTML의 문법은 작성 비용이 높다. 이에 대해 시히파어는 Claude Code가 그 비용을 줄여준다고 답한다. AI가 HTML을 생성하고, 개발자는 내용에 집중한다.
"도구가 Markdown을 중심으로 설계되었다" — VS Code, GitHub, 많은 편집기가 Markdown 우선이다. 그러나 이는 생태계의 관성이지, 본질적 한계가 아니다.
"웹 외 환경에서는 HTML을 쓸 수 없다" — 터미널 환경에서는 여전히 Markdown이 유효하다. 그러나 Claude Code의 주요 사용 시나리오인 CLI + 브라우저 조합에서는 HTML의 이점이 발휘된다.
개발자가 지금 바로 시도할 세 가지 프롬프트
시히파어가 제안하는 실전 프롬프트다.
1. 설계 문서 생성:
새로운 기능의 구현 계획을 HTML로 작성해줘. 탭으로 아키텍처, API, UI 섹션을 분리하고, 각 섹션에 collapsible 상세 내용을 포함해줘.2. 코드 리뷰 아티팩트:
이 PR의 코드 리뷰를 HTML로 작성해줘. 변경 사항을 side-by-side로 보여주고, 주요 문제를 클릭하면 상세 설명이 Appear하는 구조로 만들어줘.3. 인터랙티브 데모:
이 데이터 시각화 코드를 HTML로 변환해줘. 슬라이더로 파라미터를 조정하고, 'Copy Prompt' 버튼으로 현재 상태를 Claude에 전달할 수 있게 해줘.결론: 누가 실제로 혜택을 받는가
시히파어의 제안을 무조건 수용할 필요는 없다. 그러나 다음과 같은 상황에서는 HTML 출력이 분명한 이점이 있다:
• 긴 기술 문서나 구현 계획을 자주 작성하는 개발자
• 분산된 팀에서 비동기적으로 문서를 공유하는 환경
• 코드 리뷰, 설계 검토, 프로토타이핑을 AI로 하는 팀
• 복잡한 시각화나 인터랙티브 요소를 문서에 담아야 하는 경우
반면, 간단한 메모, 빠른 답변, CLI 문서화 등 순수 텍스트 중심의 작업에서는 Markdown이 여전히 적합하다.
핵심은 도구답게 적합한 곳에 적합한 것을 쓰는 것이다. 2026년, AI 에이전트 시대의문서작성에서 HTML이 가지는불합리적 효과 — 그 것을 시히파어는 440만 명의 시청자에게 립증했다.
📚 출처
• Using Claude Code: The Unreasonable Effectiveness of HTML — Thariq Shihipar (X/Twitter)
• HTML vs Markdown in Claude Code: Why Anthropic's Thariq Changed the Default
• GeekNews — Claude 연구원은 HTML이 Markdown보다 더 쓰기 좋다고 말했습니다.
tags: AI,Claude,Anthropic,Claude Code,HTML,Markdown,AI Tools,Development,Productivity
📚 출처
'AI 뉴스' 카테고리의 다른 글
| OpenAI의 WebRTC 문제 — 개발자가 알아야 할 핵심 정리 (0) | 2026.05.10 |
|---|---|
| AI 시대, 0→1 서비스에서 오픈보다 운영이 더 중요한 이유 완벽 가이드 (0) | 2026.05.10 |
| antirez/ds4 — Metal용 DeepSeek V4 Flash 로컬 추론 엔진 완벽 가이드 (0) | 2026.05.10 |
| Cloudflare, 인력 약 20% 감축 발표 — AI가 조직을 바꾸는 방식을 직시하다 (0) | 2026.05.10 |
| Natural Language Autoencoders: Claude의 생각을 텍스트로 바꾸기 (0) | 2026.05.10 |