URL.md 패턴이란?

AI가 HTML 파싱없이 콘텐츠를 읽게 하는 Markdown 엔드포인트

1. URL.md 패턴이란?

URL.md 패턴은 동일 URL에 .md를 붙이는 것만으로 인간용 HTML과 AI용 Markdown을 같은 URL 구조로 나란히 제공하는 설계 패턴입니다.

URL.md 패턴은 “사람에게는 HTML, AI에게는 Markdown”을 제공하는 이중 인터페이스입니다.

이 개념은 2024년 9월에 Answer.AI 공동 창설자 Jeremy Howard 씨가 제안한 llms.txt 사상의 자연스러운 확장입니다.

llms.txt → 사이트 전체 개요를 Markdown으로 제공

URL.md → 각 페이지의 상세 정보를 Markdown으로 제공

즉 URL.md 패턴은 llms.txt의 발상을 사이트의 모든 페이지로 확장한 구조라고 볼 수 있습니다.

URL 구조

/company → HTML (사람용 - 브라우저 렌더링)

/company.md → Markdown (AI용 - 순수 텍스트)

URL.md 패턴은 LLMO에서 가장 실용적인 구현 전략 중 하나입니다.

AI는 HTML 파싱(태그 제거, 네비게이션 필터링, 광고 노이즈 제거 등)이라는 불필요한 작업 없이 처음부터 클린한 Markdown 콘텐츠만을 취득할 수 있습니다.

HTML은 사람이 읽기 위한 형식이고, Markdown은 AI가 읽기 가장 쉬운 형식입니다.

2. Astro에서의 구현

URL.md 패턴의 핵심은 HTML을 Markdown으로 변환하는 것이 아니라, 처음부터 Markdown을 직접 제공하는 것입니다.

Astro에서는 **API 라우트(*.md.ts)**를 사용하여 Markdown 엔드포인트를 간단하게 구현할 수 있습니다.

이 방식은 서버에서 동적으로 변환하는 것이 아니라 빌드 시 정적 파일로 출력되기 때문에 성능에도 영향을 주지 않습니다.

Astro의 API 라우트(*.md.ts)를 사용하여 .md 엔드포인트를 생성합니다.

company.md.ts

---

import type { APIRoute } from 'astro';

export const GET: APIRoute = () => {

const content = `# 회사명 — 회사 정보

## 기본 정보

| 항목 | 내용 |

|------|------|

| 회사명 | 주식회사 샘플테크 |

| 대표자 | 홍길동 |

| 설립 | 2025년 4월 |

| 소재지 | 서울특별시 강남구 테헤란로 123 |

| 사업자등록번호 | 123-45-67890 |

## 미션

미션 스테이트먼트를 한두 문장으로 명확하게 기재합니다.

## 대표자 프로필

개발자 경력 N년. 전문 분야(LLMO, AI 에이전트 설계, 컨텍스트 엔지니어링) 설명...

## 연락처