테스트 페이지

이 문서는 문서를 .md로 작성할지 .mdx로 작성할지 판단하는 기준을 운영 관점에서 정리합니다. 단순히 “가능하다/불가능하다”가 아니라, 장기 유지보수 비용과 편집 일관성을 함께 고려해 선택할 수 있도록 구성했습니다. 팀 문서 품질을 안정적으로 유지하려면 파일 형식 선택 기준을 사전에 명확히 고정해야 합니다.

기본 원칙

운영 문서는 .md를 기본으로 사용하고, .mdx는 반드시 필요한 경우에만 선택합니다. 기본 형식을 단순하게 유지해야 작성자 교체, 리뷰, 배포 검증 과정에서 예외 처리가 줄어듭니다. 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

• 기본값: .md 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 예외값: .mdx (컴포넌트 직접 렌더링 필요 시) 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

현재 MDX 문서

현재 운영 기준에서 MDX는 랜딩 페이지 1건으로 제한해 사용합니다. 문서 전반을 MDX로 확장하지 않는 이유는 편집 일관성과 유지보수 안정성을 우선하기 때문입니다. 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

• docs/
  • src/
    • content/
      • docs/
        • index.mdx

MDX를 선택해야 하는 경우

아래 조건을 충족하면 .mdx를 선택합니다. 공통 특징은 “순수 마크다운만으로 구현하기 어려운 UI/컴포넌트 표현이 필요한 경우”입니다. 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

선택 기준

보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

• 페이지에서 컴포넌트를 직접 import/render 해야 할 때 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 마크다운만으로 구현하기 어려운 복합 레이아웃이 필요한 때 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 랜딩/쇼케이스처럼 시각 구성 비중이 높은 페이지를 만들 때 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

MDX 선택 예시 구조

• docs/
  • src/
    • content/
      • docs/
        • landing-custom/
          • index.mdx

MDX를 피해야 하는 경우

아래 유형은 .md가 더 적합합니다. 문서 목적이 정보 전달 중심이라면 MDX 도입 이점보다 유지보수 비용이 더 커질 가능성이 높습니다.

회피 기준

보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

• 단순 텍스트/이미지/표/코드 예시 문서 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 체크리스트, 절차, 운영 로그 중심 문서 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 장기 운영 문서(편집 일관성과 인수인계가 중요한 문서) 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

MD 권장 예시 구조

• docs/
  • src/
    • content/
      • docs/
        • markdown-guide/
          • elements/
            • index.md

의사결정 절차

형식 선택은 “기능 필요성 → 유지보수 영향 → 팀 편집성” 순서로 판단합니다. 아래 절차를 문서 생성 전에 확인하면 불필요한 MDX 확장을 방지할 수 있습니다.

1. 마크다운으로 구현 가능한지 먼저 검토 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
2. 컴포넌트 import가 꼭 필요한지 판단 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
3. 장기 유지보수 비용(리뷰/수정/인수인계)을 평가 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
4. 필요 시에만 .mdx 선택 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

검토 체크리스트

• 이 문서가 컴포넌트 렌더링을 반드시 요구하는가? 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 순수 마크다운으로 대체 가능한가? 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• MDX를 선택했을 때 팀 편집 난이도가 증가하는가? 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 장기 운영 문서라면 .md로 전환 가능한가? 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.
• 최종 선택 사유를 문서 생성 시점에 기록했는가? 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

동해물과 백두산이 마르고 닳도록 하느님이 보우하사 우리나라 만세. 동해물과 백두산이 마르고 닳도록 하느님이 보우하사 우리나라 만세. 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 길을 걷다 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다.

• 따뜻한 햇살이 창문으로 들어오는 것을 느끼며 천천히 눈을 떴다. 하늘과 바람과 별과 시를 노래하며 살아가는 것은 참으로 행복한 일이다. 이 기상과 이 맘으로 충성을 다하여 괴로우나 즐거우나 나라 사랑하세. 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다.
• 따뜻한 햇살이 창문으로 들어오는 것을 느끼며 천천히 눈을 떴다. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다. 오래된 책을 읽으며 조용한 오후를 보내는 것도 때로는 좋은 휴식이 된다. 길을 걷다 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 동해물과 백두산이 마르고 닳도록 하느님이 보우하사 우리나라 만세. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다.
• 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 함께하는 시간이 소중하다는 것을 알게 된 것은 그리 오래되지 않았다. 이 기상과 이 맘으로 충성을 다하여 괴로우나 즐거우나 나라 사랑하세. 길을 걷다 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 산과 들에 나무들이 푸르게 자라나고 맑은 시냇물이 흘러가고 있었다.
• 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 함께하는 시간이 소중하다는 것을 알게 된 것은 그리 오래되지 않았다. 이 기상과 이 맘으로 충성을 다하여 괴로우나 즐거우나 나라 사랑하세. 길을 걷다 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 산과 들에 나무들이 푸르게 자라나고 맑은 시냇물이 흘러가고 있었다.

1. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 오래된 책을 읽으며 조용한 오후를 보내는 것도 때로는 좋은 휴식이 된다.
2. 바다를 바라보며 파도 소리를 듣고 있으면 마음이 편안해지는 것을 느낀다. 아침 일찍 일어나 산책을 하면 하루가 상쾌하게 시작된다는 것을 느꼈다. 꽃이 피면 봄이 오고 낙엽이 지면 가을이 온다는 것을 누구나 알고 있다. 길을 걷다 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 아침 일찍 일어나 산책을 하면 하루가 상쾌하게 시작된다는 것을 느꼈다. 오래된 책을 읽으며 조용한 오후를 보내는 것도 때로는 좋은 휴식이 된다.
3. 하늘과 바람과 별과 시를 노래하며 살아가는 것은 참으로 행복한 일이다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 가을 하늘 공활한데 높고 구름 없이 밝은 달은 우리 가슴 일편단심일세. 함께하는 시간이 소중하다는 것을 알게 된 것은 그리 오래되지 않았다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 이 기상과 이 맘으로 충성을 다하여 괴로우나 즐거우나 나라 사랑하세. 하늘과 바람과 별과 시를 노래하며 살아가는 것은 참으로 행복한 일이다.

사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 함께하는 시간이 소중하다는 것을 알게 된 것은 그리 오래되지 않았다. 이 기상과 이 맘으로 충성을 다하여 괴로우나 즐거우나 나라 사랑하세. 길을 걷다 보면 예상치 못한 아름다운 풍경을 만나게 될 때가 있다. 산과 들에 나무들이 푸르게 자라나고 맑은 시냇물이 흘러가고 있었다.

이 기상과 이 맘으로 충성을 다하여 괴로우나 즐거우나 나라 사랑하세. 산과 들에 나무들이 푸르게 자라나고 맑은 시냇물이 흘러가고 있었다. 동해물과 백두산이 마르고 닳도록 하느님이 보우하사 우리나라 만세. 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다. 함께하는 시간이 소중하다는 것을 알게 된 것은 그리 오래되지 않았다.

무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 바다를 바라보며 파도 소리를 듣고 있으면 마음이 편안해지는 것을 느낀다. 어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다. 바다를 바라보며 파도 소리를 듣고 있으면 마음이 편안해지는 것을 느낀다. 아침 일찍 일어나 산책을 하면 하루가 상쾌하게 시작된다는 것을 느꼈다. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세.

어릴 적 뛰어놀던 골목길의 추억이 문득 떠올라 미소를 짓게 되었다. 이 기상과 이 맘으로 충성을 다하여 괴로우나 즐거우나 나라 사랑하세. 무궁화 삼천리 화려강산 대한사람 대한으로 길이 보전하세. 함께하는 시간이 소중하다는 것을 알게 된 것은 그리 오래되지 않았다. 사람들은 저마다의 꿈을 가지고 그것을 향해 한 걸음씩 나아가고 있다. 아침 일찍 일어나 산책을 하면 하루가 상쾌하게 시작된다는 것을 느꼈다.