FLATTO
EN문의하기
전체 아티클

ARTICLES

.md(Markdown)를 쓰는 이유, 그리고 왜 표준이 되어가고 있는가

우리의 article 페이지도 md 파일로 작성한다. 3월 9일 행사에서 여러 질문을 받은 뒤 다시 정리해보니, 결국 지금 더 중요한 건 markdown이 왜 강하고 왜 사실상 표준처럼 자리잡아가고 있는지였다.

발행일

2026년 3월 11일

작성자

한서우

#Markdown#CommonMark#AI#Documentation#Writing

우리의 article 페이지도 .md 파일로 작성한다.

3월 9일 국제 여성의 날 행사에 주한 영국대사관과 주한 캐나다대사관이 주관으로 연 행사에 패널로 참가해서, AI Engineer로서 현재 AI의 시대와 개발자가 어떤 방식으로 일하게 되는지에 대해 간단히 이야기를 나눴다. 행사 뒤 네트워킹 시간에도 여러 질문을 받았다.

질문은 다양했다. 한국에서 만든 독자 파운데이션 모델에 대한 이야기도 있었고, 언어가 다른 데이터를 어떻게 다루는지에 대한 궁금증도 있었다. Markdown 파일에 대한 이야기가 나왔는데, 왜 이게 중요한지에 대한 질문이 돌아왔었고, 100% 잘 설명을 하지 못한 것 같아서 집에 돌아와서 찾아보고, 이를 정리하게 되었다.

그래서 이 글은 왜 markdown이 점점 더 표준 같은 위치를 가져가고 있다고 느끼는지에 대한 정리다.

markdown은 단순히 README 문법이 아니다

많은 사람들이 markdown을 "개발자가 README 쓸 때 쓰는 것" 정도로 생각한다. 하지만 실제로 markdown은 훨씬 넓은 역할을 한다.

  • 문서를 빠르게 초안으로 쓸 수 있다
  • diff가 잘 보여서 Git과 잘 맞는다
  • 제목, 목록, 링크, 코드 블록 같은 구조를 가볍게 표현할 수 있다
  • 문서 사이트, 위키, 블로그, 이슈, PR, 노트로 쉽게 이어진다

즉 markdown은 예쁜 편집기보다, 쓰기와 수정과 공유를 가볍게 이어주는 작업 포맷에 가깝다.

AI 시대에는 오히려 markdown이 더 중요해진다

생성형 AI가 들어오면서 글을 덜 쓰게 된 것이 아니라 더 많이 쓰게 됐다.

  • 프롬프트를 쓴다
  • 에이전트에게 작업 지시를 적는다
  • 회의 내용을 요약한다
  • 리뷰 코멘트를 남긴다
  • 실험 로그를 정리한다
  • 릴리즈 노트나 article을 쓴다

이 흐름에서 중요한 건 "서식이 화려한 문서"가 아니다. 빠르게 쓰고, 다시 고치고, AI와 함께 다듬고, 팀과 공유할 수 있는 형식이다.

markdown은 여기에 아주 잘 맞는다. 텍스트 기반이라 사람도 읽기 쉽고, 모델도 다루기 쉽고, 변경 이력도 추적하기 쉽다. 특히 AI가 HTML보다 더 가벼운 구조화 텍스트를 다루는 상황에서는 markdown이 실용적인 중간 포맷으로 자주 선택된다.

그래서 markdown은 단순한 문서 포맷이 아니라 사람과 AI가 같이 만지는 공용 작업 포맷처럼 동작한다.

2026년, markdown은 AI 에이전트의 공용어가 되고 있다

2025–2026년 사이에 markdown의 위상이 한 단계 더 올라간 결정적인 흐름들이 있다.

Cloudflare: "Markdown for Agents"

2026년 2월, Cloudflare는 HTML 웹페이지를 AI 에이전트 요청 시 자동으로 markdown으로 변환해 제공하는 기능을 발표했다. AI 에이전트가 HTTP 헤더에 Accept: text/markdown을 포함하면, Cloudflare 엣지에서 실시간으로 HTML → Markdown 변환이 일어난다. Cloudflare 자체 블로그 기준으로 토큰 사용량이 최대 80% 감소한 것으로 보고되었다1.

이는 단순한 기능 추가가 아니다. 웹 인프라 레벨에서 AI 에이전트를 1등 시민으로 대우하기 시작했고, 그 인터페이스 포맷이 markdown이라는 점이 핵심이다.

AGENTS.md: AI를 위한 README

개발 프로젝트에서 README.md가 사람을 위한 안내서라면, AGENTS.md는 AI 코딩 에이전트를 위한 안내서로 자리잡고 있다. 프로젝트의 구조, 코딩 컨벤션, 테스트 방법, PR 가이드라인 등을 markdown으로 적어두면 AI 에이전트가 이를 읽고 맥락을 파악한다.

2025년 8월 기준 GitHub에서 20,000개 이상의 저장소가 AGENTS.md를 채택했고, 2026년 초에는 60,000개를 넘었다. OpenAI Codex, Google Jules, Cursor 등 주요 AI 코딩 도구들이 이 파일을 인식한다2. 다만 최근에는 context file이 실제 성능에 얼마나 기여하는지에 대한 재검토도 이어지고 있어서, 채택 규모와 효과 검증은 구분해서 보는 편이 정확하다3.

llms.txt: AI를 위한 robots.txt

robots.txt가 검색 엔진 크롤러를 안내하듯, llms.txt는 LLM에게 사이트의 핵심 정보를 markdown 형식으로 제공하는 제안이다. 2024년 9월 Answer.AI의 Jeremy Howard가 제안했고, Anthropic, Vercel, Cloudflare, Hugging Face 등이 채택하기 시작했다4.

여기서 주목할 점은 이 모든 새로운 표준 제안들이 markdown을 기본 포맷으로 선택했다는 사실이다.

markdown이 강한 건 내용 중심이기 때문이다

Word, 노션, 구글 문서도 물론 강력하다. 하지만 초안 단계에서는 종종 형식이 내용보다 먼저 신경 쓰이게 만든다.

반면 markdown은 거의 무조건 내용과 구조를 먼저 생각하게 만든다.

  • # 는 제목
  • - 는 bullet
  • 1. 은 ordered list
  • [text](url) 는 링크

문법이 단순해서 오히려 오래 간다. 툴이 바뀌어도 원본이 쉽게 남고, HTML이나 다른 렌더링 결과로 변환하기도 쉽다.

왜 markdown이 '표준이 되어간다'고 말할 수 있나

여기서 중요한 건 표현을 정확하게 하는 것이다.

markdown이 완전히 하나의 단일한 공식 표준으로 끝났다고 말하면 과장에 가깝다. 원래 markdown의 대표적인 문제는 "모두 markdown이라고 부르지만 구현마다 다르게 동작한다"는 점이었다.

바로 그래서 CommonMark가 나왔다. CommonMark 프로젝트는 원래 John Gruber의 markdown 설명이 충분히 엄밀하지 않았고, 오래된 구현인 Markdown.pl도 2004년 이후 사실상 멈춰 있었기 때문에, 시스템마다 렌더링 결과가 달라지는 문제가 있었다고 설명한다. (최신 공식 명세는 2024년 1월 릴리즈된 0.31.2 버전이다.)5

CommonMark는 이 문제를 줄이기 위해 더 엄격하고 상호운용 가능한 markdown 명세를 제시한다. 그리고 이건 이론에 그치지 않는다. CommonMark 사이트는 GitHub, GitLab, Reddit, Stack Overflow / Stack Exchange, Discourse 같은 큰 플랫폼들이 CommonMark를 채택했다고 직접 언급한다6.

즉 markdown은 "완벽한 단일 표준"이라기보다, CommonMark를 중심으로 사실상 표준화가 강하게 진행된 생태계라고 보는 편이 더 정확하다.

실무에서 가장 많이 만나는 건 GitHub Flavored Markdown이다

현실적으로 많은 사람들이 직접 만나는 markdown은 original markdown보다 GitHub Flavored Markdown, 즉 GFM에 가깝다.

GFM은 다음처럼 실무에서 자주 필요한 요소를 더 잘 지원한다.

  • 표(table)
  • 체크리스트(task list)
  • 취소선(strikethrough)
  • 자동 링크(autolink)

GitHub 공식 문서를 보면 markdown은 .md 파일뿐 아니라 이슈, PR, 디스커션, 댓글 전반에서 쓰인다. 이 말은 곧 markdown이 단지 문서 작성 문법이 아니라, 협업 인터페이스의 기본 언어에 가까워졌다는 뜻이다.

2025 Stack Overflow Developer Survey에서는 markdown이 3년 연속 **"가장 선호하는 비동기 협업 도구(most admired sync tool)"**로 선정되었고, 조사 대상 개발자의 84%가 AI 도구를 사용 중이거나 사용 계획이 있다고 답했다7. markdown과 AI 도구가 동시에 확산되는 건 우연이 아니다.

개발팀에서 markdown은 거의 항상 보인다.

어디에서 보이나보통 무엇을 쓰나
README프로젝트 소개, 설치법, 사용법
ISSUE문제 설명, 재현 단계
PR변경 요약, 리뷰 포인트
WIKI / DOCS가이드, 정책, 운영 문서
RELEASE NOTE변경 사항 정리
AGENTS.mdAI 에이전트를 위한 프로젝트 컨텍스트

IETF의 text/markdown도 중요한 신호다

2016년 IETF RFC 7763은 text/markdown 미디어 타입을 등록했다8.

이 문서 역시 markdown을 하나의 완전한 단일 규격으로 못 박지는 않는다. 오히려 markdown을 여러 변형이 존재하는 plain-text formatting syntaxes의 family로 설명한다.

그럼에도 불구하고 text/markdown이 등록됐다는 사실은 중요하다. 인터넷 생태계에서 markdown이 너무 널리 쓰이게 되었기 때문에, MIME 레벨에서 공통 식별자가 필요해졌다는 뜻이기 때문이다.

이건 유행어 수준의 문법에는 잘 일어나지 않는다. 그리고 2026년 현재, Cloudflare의 Markdown for Agents가 바로 이 Accept: text/markdown 헤더를 실전에서 활용하면서, RFC 7763은 10년 전의 선견지명이 현실이 된 사례가 되었다.

왜 결국 많은 도구가 markdown으로 모이게 되는가

이유는 생각보다 단순하다. markdown은 아래 조건을 동시에 만족한다.

  1. 사람이 직접 읽을 수 있다 (human-readable)
  2. 기계가 파싱하기 쉽다 (machine-parseable)
  3. Git diff에 강하다 (version-control friendly)
  4. 특정 SaaS에 덜 묶인다 (vendor-neutral)
  5. HTML보다 작성 비용이 낮다 (low authoring cost)
  6. LLM이 이미 대규모로 학습한 포맷이다 (AI-native)

그래서 문서, 블로그, 개발 협업, 지식베이스, static site, LLM 입력 포맷까지 서로 다른 영역이 markdown 위에서 만날 수 있다.

Gartner는 2026년 말까지 엔터프라이즈 앱의 40%가 AI 에이전트를 내장할 것으로 전망했다(2025년 5% 미만 대비)9. 이 에이전트들이 읽고 쓰는 공용 포맷으로 markdown이 선택되고 있다는 건, markdown의 위치가 단순한 문서 포맷을 넘어서고 있다는 뜻이다.

우리 article 페이지도 그 이유로 md 파일로 작성한다. 글을 빨리 쓰고, Git으로 관리하고, AI와 함께 다듬고, 웹 페이지로 렌더링하기 쉬운 구조이기 때문이다.

markdown 요소가 왜 실무에서 충분한가

실제로 자주 쓰는 건 생각보다 많지 않다.

  • bullet list
  • ordered list
  • inline code
  • code block
  • table
  • quote
  • horizontal rule
  • 취소선

아래처럼만 써도 대부분의 문서는 충분히 전달된다.

간단한 체크리스트

  • 초안 작성
  • 링크 추가
  • 팀 리뷰 반영

우선순위 예시

  1. 빠르게 쓴다
  2. 구조를 정리한다
  3. 필요한 링크와 근거를 붙인다
  4. 배포 가능한 형식으로 연결한다

비교 예시

항목Markdown무거운 문서 편집기
초안 속도빠름상대적으로 느림
Git diff좋음제한적
AI와의 궁합좋음중간
이식성높음툴 의존적

완벽한 편집 기능이 있어야만 좋은 문서가 되는 건 아니다.
오히려 많은 경우, 빨리 쓰고 계속 고칠 수 있는 형식이 더 강하다.

내가 markdown을 계속 쓰는 이유를 한 문장으로 줄이면

markdown은 편해서만 쓰는 게 아니다.

사람, AI, 에디터, Git, 문서 사이트, 협업 플랫폼 사이를 가장 무리 없이 연결해주는 텍스트 기반 공용 포맷이기 때문에 계속 쓰게 된다.

그리고 그래서 markdown은 단순한 취향이 아니라, 이미 여러 큰 플랫폼과 도구 위에서 사실상 기본값처럼 자리 잡아가고 있다.

참고 자료

Footnotes

  1. Cloudflare, "Markdown for Agents", 2026년 2월. AI 에이전트가 Accept: text/markdown 헤더로 요청 시 HTML을 자동 변환하며, 자체 블로그 기준 토큰 80% 감소를 보고했다. — Cloudflare Blog: Introducing Markdown for Agents ↩

  2. InfoQ, "AGENTS.md Emerges as Open Standard for AI Coding Agents", 2025. GitHub 채택 수 및 지원 도구 목록 참고. — InfoQ: AGENTS.md ↩

  3. InfoQ, "New Research Reassesses the Value of AGENTS.md Files for AI Coding", 2026. 채택 규모와 별개로 효과 검증은 아직 논쟁 중이라는 점을 정리한다. — InfoQ: AGENTS context file value review ↩

  4. Jeremy Howard / Answer.AI, "llms.txt — A Proposal", 2024년 9월. — llms.txt 공식 명세 / Answer.AI: Introducing llms.txt ↩

  5. CommonMark Spec 0.31.2, 2024년 1월 28일 릴리즈. — CommonMark Spec ↩

  6. CommonMark 공식 사이트에서 GitHub, GitLab, Reddit, Stack Overflow, Discourse 등의 채택을 직접 언급. — CommonMark 공식 사이트 ↩

  7. 2025 Stack Overflow Developer Survey. Markdown이 3년 연속 most admired sync tool. 84%의 개발자가 AI 도구 사용 중/계획. — 2025 Stack Overflow Developer Survey ↩

  8. IETF RFC 7763, "The text/markdown Media Type", 2016. — RFC 7763 전문 ↩

  9. Gartner 전망: 2026년 말까지 엔터프라이즈 앱의 40%가 task-specific AI 에이전트를 내장할 것(2025년 5% 미만 대비). — Aakash Gupta, The PM's Guide to Agent Distribution ↩