.md 대신 .html을 사용해야하는 이유 (feat. 백문이불여일견)

요즘 콘텍스트 설계(Context Engineering)를 고민하면서 출력 포맷 최적화가 얼마나 중요한지 새삼 실감하고 있다.

보통 Markdown을 선호해왔다. 막연한 생각으로 md는 에이전트 친화적이고 시각화된 html은 휴먼 친화적이라고 생각했다. 토큰, 데이터 증 특면에서 효율적이라고 생각했다. 하지만 지극히 휴먼적 생각이었다. 복잡한 작업을 수행하는 AI 에이전트(AI Agent) 환경에서는 HTML이나 XML 같은 태그(Tag) 기반 포맷이 JSON이나 단순 텍스트보다 AI 모델에게 훨씬 더 친화적이며 추론 성능을 높여준다고 한다.

모델은 단어뿐만 아니라 구조도 읽습니다. 구조가 내용보다 중요합니다.
The model reads structure, not just words. Structure beats vibes.

대규모 언어 모델(LLM)은 학습 과정에서 수많은 웹페이지 데이터를 흡수했기 때문에 HTML/XML의 계층 구조와 여닫는 태그(<tag>...</tag>) 쌍을 직관적으로 이해한다고 한다. 특히 AI 에이전트가 복잡한 다단계 추론(Multi-step reasoning), 도구 사용(Tool calling), 프롬프트 구획 분할을 수행할 때 강력한 효과를 발휘할 수 있다고 하니 앞으로는 html을 디폴트로 세팅해야할 것 같다. 

https://www.linkedin.com/posts/martino-yovo_promptengineering-ai-claude-activity-7462552108572041216-SwX0/

복잡한 일을 수행하는 AI 에이전트에게는 HTML이나 XML 같은 포맷이 훨씬 친화적이더라고 한다. 백문이 불여일견은 휴먼뿐만 아니라 AI에게도 적용되는 것 같다.

(예시, 최근 진행 중인 프로젝트.. 진행 관리 문서)

사실 돌이켜보면..

그동안 이런 작업을 md로 해왔다는 사실이 더 소름이긴하다..

기타 참조.

📚 관련 주요 레퍼런스 및 기술 문서

이러한 특성은 AI 업계의 공식 프롬프트 가이드라인과 최신 연구 논문에서 강력히 권장하는 정석 패턴입니다.

1. Anthropic(Claude) 공식 개발자 가이드

AI 에이전트 열풍을 이끈 엔트로픽(Anthropic)은 프롬프트 엔지니어링의 핵심 지침으로 XML 태그 사용을 최우선으로 강조합니다. [1]

• 내용: 복잡한 지시사항이나 데이터를 구조화할 때 XML 태그를 쓰면 Claude 모델의 정확도가 비약적으로 상승한다는 가이드라인을 제공합니다.

• 출처: Anthropic Prompt Engineering - Use XML Tags

2. OpenAI 공식 가이드라인

OpenAI 역시 복잡한 프롬프트를 작성하거나 가독성을 높일 때 Markdown 지시어와 함께 XML 태그 형태의 구분자(Delimiters)를 사용할 것을 적극 권장하고 있습니다. [1, 2]

• 출처: OpenAI Prompt Engineering Guide

3. XML Prompting 관련 연구 및 벤치마크 (2025~2026)

학계에서도 XML 기반의 프롬프트 구성이 AI의 수학적 추론, 데이터 통합, 멀티 에이전트 프로토콜 성능을 대폭 향상시킨다는 연구 결과를 내놓고 있습니다. [1]

• Emergent Mind 리포트: "XML Prompting Techniques" 연구에 따르면 문법 제약 디코딩 환경에서 XML 마크업을 활용할 때 모델의 수렴성과 에러 수정 능력이 향상됨을 실증했습니다. [1]

• HoT(Highlighted Chain of Thought) 연구 (2025): 연구진은 AI 내부의 사실 관계 파싱률을 높이기 위해 핵심 정보 주변을 XML/HTML 태그로 감싸는 방식이 모델의 답변 정확도를 눈에 띄게 개선한다는 점을 증명했습니다. [1]