위키 JSON 일괄 가져오기 (데스크탑)

언제 쓰나

• 다른 노트 앱(Notion · Obsidian · Bear · Apple Notes 등) 의 페이지 묶음을 통째로 옮길 때
• 스크립트로 자동 생성한 문서 트리(예: API 레퍼런스 · 회의록 모음) 를 한 번에 게시할 때
• 팀 위키 초기 셋업 시 카테고리 · 템플릿 페이지를 미리 만들어 둘 때

여는 방법

JSON 포맷

{
  "pages": [
    {
      "title": "1단계 — 온보딩",
      "icon": "🚀",
      "children": [
        { "title": "팀 소개" },
        { "title": "도구 셋업" }
      ]
    },
    {
      "title": "2단계 — 일하는 방식",
      "icon": "📋"
    }
  ]
}

{
  "pages": [
    {
      "title": "프로젝트 개요",
      "icon": "📘",
      "content": "<h2>목표</h2><p>2026 Q3 까지 v1.0 출시</p><ul><li>모바일 앱</li><li>API 공개</li></ul>"
    }
  ]
}

{
  "pages": [
    {
      "title": "회의록 — 2026/05/06",
      "icon": "🗒️",
      "content": "## 안건\n- v0.8.2 회고\n- 다음 스프린트\n\n## 결정 사항\n**모바일 우선** 으로 방향 확정"
    }
  ]
}

최상위에 pages 배열이 있고 각 노드에는 title (필수) · icon (선택, 이모지) · content (선택, HTML 또는 마크다운) · children (선택, 같은 형태의 배열)이 들어갑니다. children 깊이는 위키 트리의 한도(최대 4단계)를 따르며, 현재 페이지 아래로 가져올 때는 그 페이지가 있는 단계도 함께 셉니다.

사용 팁

• 드래그 & 드롭 — 모달에 .json · .zip · .enex 파일을 직접 끌어다 놓으면 읽고 분석합니다. 'JSON / ZIP / ENEX 파일 선택' 버튼을 누르지 않아도 됩니다.
• 다른 노트 앱 파일 — 'JSON 붙여넣기' 옆의 '파일 선택' 탭에서 Notion · Upnote · Apple Notes · Obsidian 의 ZIP, Evernote 의 ENEX, Simplenote · Bear 의 .json 을 그대로 읽습니다 (형식은 자동 인식). ZIP 은 폴더 구조가 페이지 트리가 되고 이미지는 자동으로 업로드됩니다.
• 위키링크 연결 — 본문의 [[페이지 제목]] 은 모든 페이지를 만든 뒤 같은 제목의 페이지 멘션으로 연결되고, 연결된 개수가 완료 화면에 표시됩니다.
• 미리보기 트리 — 가져오기 전 모달 안에서 페이지 트리를 확인하세요. ▶ 토글로 자식 노드를 접고 펼칩니다.
• 부분 실패 허용 — 일부 페이지 생성에 실패해도 나머지는 그대로 진행됩니다. 실패한 항목과 사유는 모달 하단에 표시됩니다.
• 이모지 아이콘 — title 옆 칩에 표시되는 icon 은 이모지 한 글자(🚀 📘 🗒️) 가 가장 호환성이 좋습니다. 빈 값이면 기본 페이지 아이콘을 씁니다.

주의 사항

• 가져오기는 되돌릴 수 없습니다 — 한 번 생성된 페이지는 일괄 삭제 기능이 없으므로 작은 샘플로 먼저 테스트하세요.
• 성능 — 수백 페이지 단위는 노드 하나씩 직렬로 생성합니다. 큰 트리는 1~2분이 걸릴 수 있습니다. 도중 모달을 닫지 마세요.
• 실패한 부모 — 어떤 페이지의 생성에 실패하면 그 아래 하위 페이지는 만들지 않고 건너뜁니다. 깊이 한도나 프로젝트 소유자 요금제의 위키 페이지 수 한도에 걸린 페이지도 하단의 실패 목록에 나옵니다.
• 권한 — 본인에게 편집 권한이 있는 프로젝트에서만 가져올 수 있습니다. 읽기 전용 멤버에게는 '가져오기' 메뉴 항목이 표시되지 않습니다.