md와 mdc는 둘 다 Markdown 계열의 확장자이지만, 역할과 사용 방식이 조금 다릅니다.
이 기사에서는 양자의 개요와 차이점에 대해 기술합니다.
Markdown (표준) - 가장 널리 사용되는 확장자
- 플레인(Plain) Markdown 표기법
- GitHub, Qiita, Notion, VS Code 등 거의 모든 곳에서 대응
- 문서, README, 설계서용
- README.md
- 사양서
- 의사록
- 기술 문서 전반
Markdown + 컴포넌트 / 확장 구문 - 주로 Nuxt / Vue / 문서 생성계 툴에서 사용
- Markdown에 Vue 컴포넌트나 확장 구문을 삽입할 수 있음
- 일반적인 Markdown 뷰어에서는 올바르게 표시되지 않는 경우가 많음
- 빌드 시에 해석되는 것을 전제로 함
# Hello
<MyComponent />
::alert{type="info"}
...
- Nuxt Content
- VuePress / Docus 계열의 고도화된 문서
- 컴포넌트가 포함된 문서
최근 생성 AI를 활용한 개발 도구의 보급으로 인해 .mdc 파일을 접할 기회가 늘어나고 있습니다.
AI 코드 에디터인 Cursor에서는 AI에 대한 지시나 제약을 기술하는 「Rules」 파일에 .mdc 확장자가 채택되어 있습니다 (.cursor/rules/ 아래에 배치).
---
description: 코딩 규약
globs: ["**/*.ts", "**/*.tsx"]
...
프런트매터 (Front Matter, --- 내부)에서 어떤 파일에 적용할지를 제어할 수 있으며, Markdown 본문에서 AI에 대한 지시 내용을 기술합니다.
Cursor에 이어 다른 AI 코딩 어시스턴트에서도 Markdown 기반의 규칙 파일을 사용하는 패턴이 확산되고 있으며, .md와 .mdc 중 어느 것이 채택될지는 도구에 따라 다릅니다.
| 도구 | 규칙 파일 |
|---|
| Cursor | .cursor/rules/*.mdc |
| Windsurf | .windsurfrules (.md) |
| Cline | .clinerules (.md) |
| GitHub Copilot | .github/copilot-instructions.md |
생성 AI 문맥에서의 구분 사용 경향:
- 프런트매터나 구조화된 메타데이터가 필요함 →
.mdc (Cursor 등)
- 단순한 지시 텍스트로 충분함 →
.md (Windsurf / Cline 등)
.md는 범용성이 높고 거의 모든 환경에서 사용할 수 있는 표준적인 Markdown 형식입니다.
.mdc는 컴포넌트 삽입이나 구조화된 메타데이터가 필요한 상황에서 힘을 발휘하며, Nuxt Content나 Cursor Rules 등 특정 도구와의 친화성이 높습니다.