Bulk Wiki import from JSON (desktop)
Import a bundle of documents from an external tool such as Notion, Obsidian, or Bear as a single JSON file in the desktop app. Top level plus child page hierarchy is created in one pass.
When to use it
- Moving a whole bundle of pages from another note app (Notion, Obsidian, Bear, Apple Notes, and so on)
- Publishing a script-generated document tree (an API reference, a set of meeting notes) in one pass
- Setting up a team Wiki with category and template pages prepared in advance
How to open it
Launch the desktop app
Wiki JSON import is a desktop-only feature (macOS and Windows). It does not appear in a web browser.
Open a Wiki page
Go to the Wiki menu of the project and open any page, or create a new one.
Page menu → Import data
Click the ⋯ (hamburger) menu at the top right of the page and choose 'Import data (JSON)' to open the modal.
JSON format
Minimal example — tree structure
A node with only a title is created as an empty page. Use children to nest subpages to any depth.
{
"pages": [
{
"title": "1단계 — 온보딩",
"icon": "🚀",
"children": [
{ "title": "팀 소개" },
{ "title": "도구 셋업" }
]
},
{
"title": "2단계 — 일하는 방식",
"icon": "📋"
}
]
}With body content — HTML mode (default)
HTML placed in content is rendered as-is by the Wiki editor. Standard tags such as <h2>, <p>, <ul>, <strong>, and <a> are fine.
{
"pages": [
{
"title": "프로젝트 개요",
"icon": "📘",
"content": "<h2>목표</h2><p>2026 Q3 까지 v1.0 출시</p><ul><li>모바일 앱</li><li>API 공개</li></ul>"
}
]
}With body content — Markdown mode (opt-in)
Put raw markdown in content and turn on the 'Markdown' toggle at the top right of the modal to convert it to HTML automatically during import. Useful for moving a bundle of .md files exported from another note app as-is.
{
"pages": [
{
"title": "회의록 — 2026/05/06",
"icon": "🗒️",
"content": "## 안건\n- v0.8.2 회고\n- 다음 스프린트\n\n## 결정 사항\n**모바일 우선** 으로 방향 확정"
}
]
}The top level holds a pages array, and each node has title (required), icon (optional, an emoji), content (optional, HTML or markdown), and children (optional, an array of the same shape). There is no depth limit on children.
Tips
- Drag and drop — drop a .json file straight onto the modal and it is read and parsed automatically. No need to press the file picker button.
- Preview tree — check the page tree inside the modal before importing. The ▶ toggle collapses and expands child nodes.
- Partial failures are tolerated — if some pages fail to be created the rest continue, and the failed items and reasons are shown at the bottom of the modal.
- Emoji icons — the icon shown in the chip next to the title works best as a single emoji (🚀 📘 🗒️). If it is empty, the default page icon is used.
Cautions
- An import cannot be undone — there is no bulk delete for the pages it creates, so test with a small sample first.
- Performance — hundreds of pages are created one node at a time, serially. A large tree can take one to two minutes, and the modal must stay open.
- Permissions — only projects where you have edit permission are eligible. Read-only members do not see the menu item at all.