프로젝트 관리위키데스크탑마이그레이션
위키 JSON 일괄 가져오기 (데스크탑)
Notion·Obsidian·Bear 등 외부 도구의 문서 묶음을 데스크탑 앱에서 단일 JSON 으로 가져옵니다. 1depth + 자식 페이지 계층까지 한 번에 생성.
약 4분 2026년 5월 6일 업데이트
언제 쓰나
- 다른 노트 앱(Notion · Obsidian · Bear · Apple Notes 등) 의 페이지 묶음을 통째로 옮길 때
- 스크립트로 자동 생성한 문서 트리(예: API 레퍼런스 · 회의록 모음) 를 한 번에 게시할 때
- 팀 위키 초기 셋업 시 카테고리 · 템플릿 페이지를 미리 만들어 둘 때
여는 방법
1
데스크탑 앱 실행
위키 JSON 가져오기는 데스크탑 앱(macOS · Windows) 전용 기능입니다. 웹 브라우저에선 보이지 않습니다.
참고웹에서도 페이지를 하나씩 만들 수는 있지만, 트리 일괄 생성 + 로컬 .json 파일 직접 읽기는 데스크탑만 지원.
2
위키 페이지 열기
프로젝트의 위키 메뉴로 진입한 뒤 아무 페이지나 열거나, 새 페이지를 생성합니다.
3
페이지 메뉴 → 데이터 가져오기
페이지 우측 상단의 ⋯ (햄버거) 메뉴를 클릭 → '데이터 가져오기 (JSON)' 항목을 선택하면 모달이 열립니다.
TIP현재 페이지가 부모 페이지로 지정되어, 가져온 트리가 그 아래에 생성됩니다. 최상위에 만들고 싶으면 페이지 트리의 빈 공간에서 새 페이지로 시작하세요.
JSON 포맷
1
최소 예시 — 트리 구조
title 만 있어도 빈 페이지로 생성됩니다. children 으로 하위 페이지를 임의 깊이 중첩 가능.
wiki-import.jsonjson
{
"pages": [
{
"title": "1단계 — 온보딩",
"icon": "🚀",
"children": [
{ "title": "팀 소개" },
{ "title": "도구 셋업" }
]
},
{
"title": "2단계 — 일하는 방식",
"icon": "📋"
}
]
}2
본문 포함 — HTML 모드 (기본)
content 에 HTML 을 그대로 넣으면 위키 에디터가 그대로 렌더합니다. <h2>·<p>·<ul>·<strong>·<a> 등 표준 태그 OK.
wiki-import.jsonjson
{
"pages": [
{
"title": "프로젝트 개요",
"icon": "📘",
"content": "<h2>목표</h2><p>2026 Q3 까지 v1.0 출시</p><ul><li>모바일 앱</li><li>API 공개</li></ul>"
}
]
}3
본문 포함 — Markdown 모드 (옵트인)
content 에 마크다운 원문을 넣고 모달 우측 상단의 'Markdown' 토글을 켜면 가져올 때 자동으로 HTML 로 변환됩니다. 외부 노트 앱에서 추출한 .md 파일 묶음을 그대로 옮길 때 유용합니다.
wiki-import.jsonjson
{
"pages": [
{
"title": "회의록 — 2026/05/06",
"icon": "🗒️",
"content": "## 안건\n- v0.8.2 회고\n- 다음 스프린트\n\n## 결정 사항\n**모바일 우선** 으로 방향 확정"
}
]
}TIPGFM(테이블·체크박스·링크) + 단일 줄바꿈을 줄바꿈으로 보존하는 옵션이 켜져 있어, 보통의 노트 앱 export 와 자연스럽게 호환됩니다.
최상위에 pages 배열이 있고, 각 노드는 title (필수) · icon (선택, 이모지) · content (선택, HTML 또는 마크다운) · children (선택, 같은 형태의 배열) 을 가집니다. children 깊이 제한은 없습니다.
사용 팁
- 드래그 & 드롭 — 모달에 .json 파일을 직접 끌어다 놓으면 자동으로 읽고 파싱합니다. 'JSON 파일 선택' 버튼을 누를 필요 없음.
- 미리보기 트리 — 가져오기 전 모달 안에서 페이지 트리를 확인할 수 있습니다. ▶ 토글로 자식 노드를 접고 펼침.
- 부분 실패 허용 — 일부 페이지 생성에 실패해도 나머지는 그대로 진행되며, 실패한 항목과 사유가 모달 하단에 표시됩니다.
- 이모지 아이콘 — title 옆 칩에 표시되는 icon 은 이모지 한 글자(🚀 📘 🗒️) 가 가장 호환성이 좋습니다. 빈 값이면 기본 페이지 아이콘 사용.
주의 사항
- 가져오기는 되돌릴 수 없습니다 — 한 번 생성된 페이지는 일괄 삭제 기능이 없으므로, 작은 샘플로 먼저 테스트하세요.
- 성능 — 수백 페이지 단위는 노드 하나씩 직렬로 생성합니다. 큰 트리는 1~2분이 걸릴 수 있고, 도중 모달을 닫지 마세요.
- 권한 — 본인이 편집 권한을 가진 프로젝트에서만 가능합니다. 읽기 전용 멤버는 메뉴 자체가 노출되지 않습니다.