GitHub Sync는 GitHub 저장소의 .md 파일을 Framer CMS 컬렉션에 자동으로 가져오는 플러그인입니다. 마크다운 문서를 콘텐츠로 활용하는 팀이라면, 더 이상 Framer에서 일일이 복사·붙여넣기 하지 않아도 돼요.

주요기능

GitHub에서 자동으로 콘텐츠 가져오기

정해진 폴더의 .md 파일을 Framer CMS 컬렉션에 동기화합니다.

• 폴더 단위 동기화: 저장소 내 특정 경로를 지정해, 필요한 콘텐츠만 선택적으로 연동할 수 있어요.

• Frontmatter 지원: 마크다운 상단의 YAML 정보를 읽어 CMS 필드로 자동 매핑됩니다. 날짜, 태그, 요약 등 다양한 메타데이터 활용이 가능해요.

• 마크다운 포맷 유지: 글머리표, 제목, 링크 등 마크다운 문법이 그대로 적용되며, .mdx 파일도 일부 지원됩니다.

이미지·링크 경로 자동 정리

상대 경로 이미지나 파일도 자동으로 찾아서 적용합니다.

• ./image.png처럼 상대 경로로 삽입한 이미지도, 플러그인이 저장소 내에서 자동 검색해 연결합니다.

• 절대 경로(https://...)는 그대로 유지되고, 경로가 잘못된 경우에는 자동으로 제거되어 깨진 링크를 방지합니다.

복잡한 구조 정리

깊게 중첩된 디렉토리 구조(예시: docs/guides/getting-started.md → 슬러그: docs/guides/getting-started)도 슬러그로 깔끔하게 정리됩니다. 또한 중첩된 구조로 컬렉션을 나누고 싶다면, 각 폴더마다 개별 컬렉션을 만들어 연동할 수 있습니다.

프라이빗 저장소 지원

개인 액세스 토큰을 통해 비공개 GitHub 저장소도 안전하게 연동할 수 있습니다.

추가 정보

.mdx 파일은 마크다운으로 처리되며, React 컴포넌트나 JavaScript 코드는 무시됩니다. 중간에 GitHub 폴더 구조가 바뀌면, base path도 함께 수정해야 일관된 동기화를 유지할 수 있으니 참고해주세요.