Claude Code에서 Markdown 대신 HTML을 써야 하는 순간

Claude Code는 Markdown을 아주 잘 씁니다. 하지만 모든 결과물을 Markdown으로 받을 필요는 없습니다.

Claude Code 팀의 Thariq은 HTML을 출력 형식으로 선호하는 경우가 늘고 있다고 말했습니다. 이유는 간단합니다. HTML은 문서가 아니라 사람이 읽고 조작할 수 있는 화면을 만들 수 있기 때문입니다.

이런 경우 HTML이 좋습니다

• PR 설명과 리뷰 체크리스트

• 설계안 비교

• 아키텍처 설명

• 코드베이스 온보딩

• 조사 리포트

• 임시 작업 보드

프롬프트 예시:

Create a single self-contained HTML file.
Explain this feature with a summary, diagram, annotated snippets,
risks, and a next-step checklist.

Markdown이 더 좋은 경우

README, CHANGELOG, API 문서, ADR처럼 오래 보관하고 Git diff로 리뷰해야 하는 문서는 Markdown이 더 적합합니다.

기준

• 저장할 문서: Markdown

• 읽고 비교하고 결정할 문서: HTML

AI가 HTML을 만드는 비용은 낮습니다. 반대로 사람이 긴 Markdown을 읽는 비용은 높습니다. 이 차이를 이해하면 Claude Code를 더 유용하게 쓸 수 있습니다.

EvoLink는 Claude와 여러 AI 모델을 하나의 API에서 사용할 수 있게 해주는 통합 게이트웨이입니다.