Repolode
sdorra

sdorra/content-collections

로컬 Markdown, MDX, JSON, YAML 파일을 웹 앱용 타입 안전 데이터 컬렉션으로 변환하는 TypeScript 도구입니다.

스타
1,203
포크
53
열린 이슈
54
마지막 커밋
24시간 전

어떤 프로젝트인가요?

Content Collections는 디렉터리에서 파일을 불러와 앱에서 바로 import할 수 있는 타입 지정 데이터 컬렉션으로 변환합니다. 콘텐츠 파일을 가져와 파싱하는 코드를 직접 작성하는 대신, 스키마가 포함된 config 파일에서 컬렉션을 정의하면 빌드 중에 콘텐츠를 파싱하고 검증합니다.

스키마가 각 항목을 검증하므로 잘못되었거나 누락된 필드를 빌드 시점에 확인할 수 있습니다. 항목을 앱에 전달하기 전에 변환할 수도 있습니다. 예를 들어 Markdown을 렌더링하거나, 컬렉션을 결합하거나, 서버에서 데이터를 가져올 수 있습니다. 개발 중에는 서버를 다시 시작하거나 브라우저를 새로고침하지 않아도 콘텐츠 변경 사항이 컬렉션에 반영됩니다.

Next.js, Remix (Vite), SvelteKit, Solid Start, Qwik, Vite용 어댑터를 제공하며, 그 밖의 프레임워크에서는 CLI를 사용할 수 있습니다.

핵심 기능

  • 01스키마가 포함된 config 파일에서 타입 지정 컬렉션을 정의합니다.
  • 02빌드 중 콘텐츠를 검증해 오류를 조기에 발견합니다.
  • 03개발 중 콘텐츠가 변경되면 컬렉션을 자동으로 업데이트합니다.
  • 04항목을 앱에 전달하기 전에 변환할 수 있습니다.
  • 05여러 프레임워크용 어댑터와 그 밖의 프레임워크를 위한 CLI를 제공합니다.

활용 사례

  • Next.js 또는 SvelteKit 프로젝트에서 Markdown이나 MDX 파일을 사용해 블로그 또는 문서 사이트를 구축합니다.
  • Vite 앱에서 구조화된 YAML 또는 JSON 데이터를 타입 지정 객체로 불러옵니다.
  • 콘텐츠 디렉터리를 검증해 형식이 잘못된 항목이 있으면 빌드에 실패하도록 합니다.

빠른 시작

  1. 1

    프레임워크 어댑터를 선택하고 README 링크에서 설치 가이드를 따르세요

  2. 2

    프로젝트 루트에 content-collections.ts 파일을 만들고 컬렉션을 정의하세요

  3. 3

    컬렉션 디렉터리에 Markdown 콘텐츠를 작성한 다음, 생성된 컬렉션을 앱으로 가져오세요

포함된 컬렉션

토픽

자주 묻는 질문

content-collections은(는) 무엇인가요?
로컬 Markdown, MDX, JSON, YAML 파일을 웹 앱용 타입 안전 데이터 컬렉션으로 변환하는 TypeScript 도구입니다. Content Collections는 디렉터리에서 파일을 불러와 앱에서 바로 import할 수 있는 타입 지정 데이터 컬렉션으로 변환합니다. 콘텐츠 파일을 가져와 파싱하는 코드를 직접 작성하는 대신, 스키마가 포함된 config 파일에서 컬렉션을 정의하면 빌드 중에 콘텐츠를 파싱하고 검증합니다.
content-collections은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
content-collections은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
content-collections은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. content-collections의 마지막 커밋은 2026년 11월 6일입니다.
content-collections은(는) 어디에 사용할 수 있나요?
Next.js 또는 SvelteKit 프로젝트에서 Markdown이나 MDX 파일을 사용해 블로그 또는 문서 사이트를 구축합니다. Vite 앱에서 구조화된 YAML 또는 JSON 데이터를 타입 지정 객체로 불러옵니다. 콘텐츠 디렉터리를 검증해 형식이 잘못된 항목이 있으면 빌드에 실패하도록 합니다.
content-collections는 어떻게 설치하나요?
프레임워크 어댑터를 선택하고 README 링크에서 설치 가이드를 따르세요 프로젝트 루트에 content-collections.ts 파일을 만들고 컬렉션을 정의하세요 컬렉션 디렉터리에 Markdown 콘텐츠를 작성한 다음, 생성된 컬렉션을 앱으로 가져오세요
content-collections은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/sdorra/content-collections

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트