#!/usr/bin/env node /** * MDX to Clean MD Converter for OpenAI File Search * * 섹션별로 통합된 MD 파일 생성, RAG 최적화 네비게이션 포함 * * Usage: * node scripts/mdx-to-md.js * * Output: * ./scripts/output/ 폴더에 섹션별 MD 파일 생성 */ const fs = require('fs'); const path = require('path'); const SOURCE_DIR = path.join(__dirname, '../ko'); const OUTPUT_DIR = path.join(__dirname, 'output'); // 섹션 정의 (순서대로) - pages는 자동 감지 const SECTIONS = [ { id: '01-ad-control', title: 'Ad.Control', description: 'Ad.Control 소개와 빠른 시작 가이드', folder: 'getting-started' }, { id: '02-ad-platform', title: '광고 플랫폼 배포', description: '자체 광고 플랫폼을 구축하고 설정하는 방법', folder: 'ad-platform' }, { id: '03-ad-unit', title: '광고 유닛 설정', description: '광고가 표시될 위치와 형식을 설정하는 방법', folder: 'ad-unit' }, { id: '04-ad-product', title: '광고 상품 만들기', description: '광고주에게 판매할 광고 상품을 만드는 방법', folder: 'ad-product' }, { id: '05-targeting', title: '타겟팅 구성', description: '광고 타겟팅 옵션을 설정하는 방법', folder: 'targeting' }, { id: '06-campaign', title: '캠페인 예약', description: '광고 캠페인을 예약하고 운영하는 방법', folder: 'campaign' }, { id: '07-management', title: '캠페인 관리', description: '진행 중인 캠페인을 관리하고 모니터링하는 방법', folder: 'management' }, { id: '08-settlement', title: '수익금 정산', description: '광고 수익금을 정산받는 방법', folder: 'settlement' }, { id: '09-sdk-overview', title: 'SDK 가이드 개요', description: 'SDK 연동을 위한 사전 준비사항', folder: 'sdk', onlyIndex: true }, { id: '10-sdk-ai', title: 'AI 도구 연동', description: 'Claude Code, Cursor 등 AI 도구에서 SDK 문서 활용하기', folder: 'sdk/ai' }, { id: '11-sdk-android', title: 'Android SDK', description: 'Android 앱에 광고 SDK를 연동하는 방법', folder: 'sdk/android' }, { id: '12-sdk-ios', title: 'iOS SDK', description: 'iOS 앱에 광고 SDK를 연동하는 방법', folder: 'sdk/ios' }, { id: '13-sdk-react-native', title: 'React Native SDK', description: 'React Native 앱에 광고 SDK를 연동하는 방법', folder: 'sdk/react-native' }, { id: '14-sdk-flutter', title: 'Flutter SDK', description: 'Flutter 앱에 광고 SDK를 연동하는 방법', folder: 'sdk/flutter' }, { id: '15-sdk-web', title: 'Web SDK', description: '웹사이트에 광고 SDK를 연동하는 방법', folder: 'sdk/web' }, { id: '16-sdk-rest-api', title: 'REST API', description: 'REST API를 통해 광고를 연동하는 방법', folder: 'sdk/rest-api' } ]; // 폴더에서 페이지 목록 자동 감지 function getPagesFromFolder(folderPath, onlyIndex = false) { const fullPath = path.join(SOURCE_DIR, folderPath); if (!fs.existsSync(fullPath)) return []; let files = fs.readdirSync(fullPath) .filter(f => f.endsWith('.mdx')) .map(f => f.replace('.mdx', '')); if (files.length === 0) return []; if (onlyIndex) { return files.filter(f => f === 'index'); } // 정렬: index/quickstart 먼저, 나머지는 알파벳순 const priority = ['index', 'overview', 'quickstart']; return files.sort((a, b) => { const aIdx = priority.indexOf(a); const bIdx = priority.indexOf(b); if (aIdx !== -1 && bIdx !== -1) return aIdx - bIdx; if (aIdx !== -1) return -1; if (bIdx !== -1) return 1; return a.localeCompare(b); }); } // MDX 컴포넌트 변환 규칙 const transformRules = [ // → **참고:** { pattern: /\s*([\s\S]*?)\s*<\/Note>/g, replace: (_, content) => `> **참고:** ${content.trim()}\n` }, // → **주의:** { pattern: /\s*([\s\S]*?)\s*<\/Warning>/g, replace: (_, content) => `> **주의:** ${content.trim()}\n` }, // → **팁:** { pattern: /\s*([\s\S]*?)\s*<\/Tip>/g, replace: (_, content) => `> **팁:** ${content.trim()}\n` }, // → **정보:** { pattern: /\s*([\s\S]*?)\s*<\/Info>/g, replace: (_, content) => `> **정보:** ${content.trim()}\n` }, // + → ### 탭제목 { pattern: /\s*([\s\S]*?)\s*<\/Tabs>/g, replace: (_, content) => { return content.replace(/\s*([\s\S]*?)\s*<\/Tab>/g, (_, title, tabContent) => `#### ${title}\n\n${tabContent.trim()}\n\n` ); } }, // → ### 제목 + 내용 { pattern: /]*>\s*([\s\S]*?)\s*<\/Card>/g, replace: (_, title, content) => `#### ${title}\n\n${content.trim()}\n\n` }, // 제거 (내용만 유지) { pattern: /]*>\s*([\s\S]*?)\s*<\/CardGroup>/g, replace: (_, content) => content }, // + → 번호 목록 { pattern: /\s*([\s\S]*?)\s*<\/Steps>/g, replace: (_, content) => { let stepNum = 0; return content.replace(/\s*([\s\S]*?)\s*<\/Step>/g, (_, title, stepContent) => { stepNum++; return `**${stepNum}. ${title}**\n\n${stepContent.trim()}\n\n`; } ); } }, // 내 → Q&A 형식 (FAQ용) { pattern: /\s*([\s\S]*?)\s*<\/AccordionGroup>/g, replace: (_, content) => { return content.replace(/\s*([\s\S]*?)\s*<\/Accordion>/g, (_, question, answer) => `**Q: ${question}**\nA: ${answer.trim()}\n\n` ); } }, // 단독 → ### 제목 { pattern: /\s*([\s\S]*?)\s*<\/Accordion>/g, replace: (_, title, content) => `#### ${title}\n\n${content.trim()}\n\n` }, // 제거 (내용만 유지) { pattern: /]*>\s*([\s\S]*?)\s*<\/Frame>/g, replace: (_, content) => content }, // → 그대로 코드블록들 유지 { pattern: /\s*([\s\S]*?)\s*<\/CodeGroup>/g, replace: (_, content) => content }, // (changelog) → ### 날짜 { pattern: /\s*([\s\S]*?)\s*<\/Update>/g, replace: (_, label, content) => `#### ${label}\n\n${content.trim()}\n\n` }, // → ✓ { pattern: /\s*([\s\S]*?)\s*<\/Check>/g, replace: (_, content) => `✓ ${content.trim()}\n` }, // 남은 HTML 태그 정리 (속성 포함) { pattern: /<\/?[a-zA-Z][^>]*>/g, replace: '' }, // 연속 빈 줄 정리 { pattern: /\n{3,}/g, replace: '\n\n' } ]; function transformMdx(content) { let result = content; for (const rule of transformRules) { result = result.replace(rule.pattern, rule.replace); } return result.trim(); } function extractFrontmatter(content) { const match = content.match(/^---\n([\s\S]*?)\n---/); if (!match) return { frontmatter: {}, body: content }; const frontmatterStr = match[1]; const body = content.slice(match[0].length).trim(); const frontmatter = {}; frontmatterStr.split('\n').forEach(line => { const colonIdx = line.indexOf(':'); if (colonIdx > 0) { const key = line.slice(0, colonIdx).trim(); let value = line.slice(colonIdx + 1).trim(); if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) { value = value.slice(1, -1); } frontmatter[key] = value; } }); return { frontmatter, body }; } function getUrlPath(folder, page) { const domain = 'https://docs.adrop.io'; if (page === 'index') { return `${domain}/ko/${folder}`; } return `${domain}/ko/${folder}/${page}`; } function processSection(section, sectionIndex, totalSections) { const pages = []; const pageNames = getPagesFromFolder(section.folder, section.onlyIndex); for (const pageName of pageNames) { const filePath = path.join(SOURCE_DIR, section.folder, `${pageName}.mdx`); if (!fs.existsSync(filePath)) continue; const content = fs.readFileSync(filePath, 'utf-8'); const { frontmatter, body } = extractFrontmatter(content); pages.push({ name: pageName, title: frontmatter.sidebarTitle || frontmatter.title || pageName, description: frontmatter.description || '', content: transformMdx(body), urlPath: getUrlPath(section.folder, pageName) }); } if (pages.length === 0) return null; // 섹션 문서 생성 let output = ''; // 섹션 헤더 output += `# ${section.title}\n\n`; output += `${section.description}\n\n`; // 섹션 네비게이션 정보 output += `---\n`; output += `## 문서 정보\n\n`; const prevSection = sectionIndex > 0 ? SECTIONS[sectionIndex - 1] : null; const nextSection = sectionIndex < totalSections - 1 ? SECTIONS[sectionIndex + 1] : null; if (prevSection) { output += `**이전 섹션:** 이 문서를 읽기 전에 "${prevSection.title}" 섹션을 먼저 확인하세요.\n`; } if (nextSection) { output += `**다음 섹션:** 이 섹션을 완료한 후 "${nextSection.title}" 섹션으로 진행하세요.\n`; } // 섹션 내 목차 output += `\n### 이 섹션의 문서\n\n`; pages.forEach((page, idx) => { output += `${idx + 1}. ${page.title} (${page.urlPath})\n`; }); output += `\n---\n\n`; // 각 페이지 내용 pages.forEach((page, pageIndex) => { output += `## ${page.title}\n\n`; output += `**문서 경로:** ${page.urlPath}\n`; if (page.description) { output += `**문서 목적:** ${page.description}\n`; } // 페이지 네비게이션 const prevPage = pageIndex > 0 ? pages[pageIndex - 1] : null; const nextPage = pageIndex < pages.length - 1 ? pages[pageIndex + 1] : null; if (prevPage) { output += `**이전 문서:** "${prevPage.title}" (${prevPage.urlPath})\n`; } if (nextPage) { output += `**다음 문서:** "${nextPage.title}" (${nextPage.urlPath})\n`; } output += `\n`; output += page.content; output += `\n\n---\n\n`; }); return output; } function main() { console.log('MDX to MD 변환 시작 (섹션별 통합)...\n'); console.log(`소스: ${SOURCE_DIR}`); console.log(`출력: ${OUTPUT_DIR}\n`); // 출력 폴더 생성 if (!fs.existsSync(OUTPUT_DIR)) { fs.mkdirSync(OUTPUT_DIR, { recursive: true }); } // 기존 파일 정리 const existingFiles = fs.readdirSync(OUTPUT_DIR).filter(f => f.endsWith('.md')); for (const file of existingFiles) { fs.unlinkSync(path.join(OUTPUT_DIR, file)); } let converted = 0; const activeSections = SECTIONS.filter(s => !s.id.includes('release-notes')); for (let i = 0; i < activeSections.length; i++) { const section = activeSections[i]; try { const output = processSection(section, i, activeSections.length); if (output) { const outputPath = path.join(OUTPUT_DIR, `docs-${section.id}.md`); fs.writeFileSync(outputPath, output, 'utf-8'); console.log(`✓ docs-${section.id}.md (${section.title})`); converted++; } else { console.log(`⚠ ${section.id} - 파일 없음`); } } catch (error) { console.error(`✗ ${section.id}: ${error.message}`); } } console.log(`\n변환 완료: ${converted}개 섹션`); console.log(`출력 위치: ${OUTPUT_DIR}`); } main();

SDK 가이드

AI

Android

iOS

React Native

Flutter

Web

REST API

React Example

CDN Example