개요

text/markdown은 Markdown 문서를 위한 미디어 타입입니다(RFC 7763). 가벼운 기호(#·*·`)로 서식을 표현하는 평문 마크업으로, README·문서·블로그 원고·이슈 코멘트에 널리 쓰입니다.

자세히

RFC 7763은 선택적 `variant` 파라미터를 정의해 어떤 Markdown 방언인지 표시할 수 있게 했습니다(예: `text/markdown; variant=GFM`은 GitHub Flavored Markdown). Markdown에는 CommonMark·GFM·MultiMarkdown 등 여러 방언이 있어 표·체크박스·각주 지원이 서로 달라, 정확한 렌더링을 위해 variant를 명시하는 것이 유용합니다.

브라우저는 Markdown을 자동 렌더링하지 않고 대개 평문으로 표시하거나 다운로드합니다. 화면에 예쁘게 보이려면 서버나 클라이언트가 HTML로 변환해야 합니다. 사용자가 작성한 Markdown을 HTML로 변환해 표시할 때는, Markdown이 원시 HTML 삽입을 허용하는 방언이면 `<script>`가 들어와 XSS가 되므로 변환 후 DOMPurify 같은 살균기로 정화해야 합니다.

문법

e.g. Content-Type: text/markdown; charset=utf-8

파일 확장자

실무 참고

• Markdown→HTML 변환 시 원시 HTML/스크립트 삽입 위험이 있어, 신뢰할 수 없는 입력은 반드시 살균(sanitize)하세요.
• 방언(CommonMark·GFM 등)마다 문법 지원이 달라 같은 텍스트가 다르게 렌더링됩니다. variant 파라미터로 의도를 밝히세요.
• charset=utf-8을 명시해 한글·이모지·코드 블록 내용을 안전하게 전달하세요.

관련 타입

관련 헤더