MDC(Markdown with Metadata)

개요

MDC(Markdown with Metadata)는 기존 Markdown 문법에 **구조화된 메타데이터(YAML Front Matter 등)**를 결합한 콘텐츠 표현 형식입니다. 주로 정적 사이트 생성기(SSG), 블로그 플랫폼, 기술 문서 시스템 등에서 사용되며, 콘텐츠와 관련된 데이터(작성자, 날짜, 태그, 슬러그 등)를 문서 상단에 포함시켜 콘텐츠 관리 자동화, SEO, 배포 유연성을 높여줍니다.

---

1. 개념 및 정의

항목	설명
정의	MDC는 Markdown 본문과 YAML 기반 메타데이터 블록이 조합된 문서 형식입니다.
목적	콘텐츠 콘텐츠 + 데이터 기반 워크플로우를 통합하여 정적 웹과 콘텐츠 관리 시스템을 연결
필요성	콘텐츠 분류, 검색, 배포 등을 위해 구조화된 정보가 필요하며 Markdown 단독으로는 한계가 존재함

---

2. 특징

항목	설명	효과
구조화된 메타데이터	콘텐츠 상단에 YAML 블록 삽입	작성자, 태그, 퍼블리시 여부 등 관리 가능
SSG/Headless CMS 호환	Gatsby, Hugo, Astro 등과 연계	SEO 최적화 및 자동 배포 가능
작성자 친화적	기술 문서 작성에 특화된 단순 문법 유지	생산성 향상

Markdown의 간결성과 JSON/YAML 기반 구조화를 동시에 갖춘 포맷입니다.

---

3. 구성 예시

---
title: "MDC란 무엇인가"
date: 2024-05-10
author: "Kim Dev"
tags: [Markdown, Metadata, SSG]
slug: mdc-overview
published: true
---

## Markdown 본문 시작
MDC는...

구성 요소	설명
---	메타데이터 블록 시작/종료 구분자
title, date 등	키-값 형식의 속성 정의
본문	순수 Markdown 문법 기반 콘텐츠 영역

---

4. 기술 요소 및 연동 시스템

기술 요소	설명	연동 플랫폼
YAML Front Matter	메타데이터 정의 방식	Gatsby, Jekyll, Hugo 등
MDX 지원	JSX를 포함한 Markdown 확장	Next.js, Docusaurus
정적 사이트 생성기(SSG)	Markdown 기반 페이지 생성	Astro, Nuxt Content, Eleventy
Headless CMS	API 기반 콘텐츠 데이터화	Contentful, Sanity, Strapi

MDC는 단일 문서로 콘텐츠와 데이터의 경계를 없앱니다.

---

5. 장점 및 이점

항목	설명	기대 효과
콘텐츠 자동화 가능	메타정보 기반 콘텐츠 렌더링	태그 기반 필터링, 날짜 정렬 등
SEO 최적화 용이	검색 엔진 친화적 정보 명시	메타 제목, 설명 자동 삽입
마크다운 작성 연계	개발자 친화적 문서화 방식 유지	Git 기반 협업 가능
유연한 확장성	마크다운 외부 UI/로직 통합 가능	MDX, Custom Components

CMS의 무게감 없이 유연하고 구조적인 콘텐츠 운영이 가능합니다.

---

6. 주요 활용 사례 및 고려사항

사례	활용 방식	고려사항
기술 블로그	작성자/태그/카테고리 기반 정렬	폴더 구조 및 태그 체계 정립 필요
문서 포털	버전, 플랫폼, 릴리스 노트 포함 문서 관리	버전별 slug 및 조건 렌더링 필요
다국어 콘텐츠	다국어 메타데이터 연계 문서 구성	i18n 키와 언어 구분 방식 정리 필요
프로젝트 위키	모듈/팀별 문서화 및 정리	사용자 권한 관리 병행 필요

메타데이터의 표준화 및 일관성이 콘텐츠 스케일의 핵심입니다.

---

7. 결론

MDC(Markdown with Metadata)는 콘텐츠 중심 시대에 가장 실용적이고 개발자 친화적인 문서 포맷입니다. Markdown의 간결성과 YAML의 구조화 데이터를 결합하여 콘텐츠 관리, 검색 최적화, 자동화 배포 등의 가능성을 열어줍니다. 복잡한 CMS를 대체하거나 연동할 수 있는 유연성과 효율성 덕분에 기술 문서, 블로그, 위키, 프로젝트 노트 등 다양한 분야에서 빠르게 확산되고 있습니다.