폴더 동기화 — 로컬 폴더 ↔ 위키 양방향

어떤 사용자에게 유용한가

• Obsidian 폴더 — 기존 폴더 그대로 연결, 양방향 sync 시작
• iCloud Drive 의 회의록 폴더 — 모바일/맥에서 적은 노트가 자동으로 Tabple 위키로
• Dropbox 공유 폴더 — 팀원이 폴더에 추가한 .md 가 곧바로 위키 페이지로 등장
• 로컬 백업 — 위키 본문이 항상 .md 파일로 디스크에 보존되어 vendor lock-in 없음

이미 iCloud Drive · Dropbox · Google Drive 같은 클라우드 폴더에 .md 노트를 쌓아뒀다면, 폴더 동기화로 그 폴더를 Tabple 위키와 통째로 연결하세요. Obsidian 사용자는 기존 폴더를 그대로 가리키면 됩니다. 폴더에 파일을 만들면 위키에 페이지가 생기고, 위키에서 편집한 본문은 .md 파일로 다시 저장됩니다. 둘 중 어디에서 작업하든 양쪽이 같은 상태를 유지합니다.

시작하기 (3단계)

4가지 시나리오 자동 분기

• 둘 다 비어있음 — 즉시 sync 를 시작합니다. 폴더에 .md 를 만들거나 위키에서 페이지를 만들면 양쪽에 반영됩니다.
• 폴더에만 .md 가 있음 — 폴더의 .md 들을 위키로 가져옵니다. 4단계 초과 폴더는 사전 경고 후 sync 에서 제외합니다.
• 위키에만 페이지 있음 — '위키를 폴더로 다운로드' 를 권합니다 (양방향 sync 즉시 가능). 또는 '로컬 폴더만 사용' 으로 기존 위키를 무시할 수도 있습니다.
• 양쪽 모두 콘텐츠 — 정본을 골라야 합니다. 로컬 폴더 정본 (로컬 폴더의 .md 가 위키로) 또는 위키 정본 (위키 본문이 .md 로, 기존 .md 는 .conflict-<날짜>.md 자동 백업).

폴더를 선택하면 시스템이 폴더와 위키 양쪽 상태를 분석해 어떤 시작 방식이 안전한지 알려줍니다. 데이터 손실을 막기 위해 사용자 확인 없이는 어느 쪽도 덮어쓰지 않습니다.

일상 사용 — 무엇이 자동인가

---
title: 회의록 2026-05-08
icon: 📄
---

<!-- tabple_id: 1234 -->

# 회의록 본문…

• Finder/Explorer 에서 .md 파일을 만들면 보통 1~2초 안에 위키 페이지로 등장
• 위키에서 본문을 편집하면 5초 안에 같은 .md 파일이 갱신됨
• 폴더 = 부모 페이지, 하위 폴더 = 자식 페이지 트리로 매핑
• [[페이지명]] 위키 링크는 PageMention chip 으로 자동 변환
• T-123 형식 텍스트는 TaskMention chip 으로 자동 변환
• 체크리스트(- [ ]) · 표 · 코드블록 · 이미지 링크는 round-trip 안전 (로컬 폴더 ↔ 위키 왕복 시 손실 없음)

충돌이 생기면

주의사항 & 한계

• Tabple 위키 트리는 4단계 깊이까지만 지원 — 폴더가 5단계 이상이면 그 파일은 sync 에서 제외됩니다 (모달이 사전 안내). 평탄화 예: 회의록/2026/05/08.md → 회의록/2026-05-08.md
• .md 파일을 로컬 폴더에서 삭제해도 위키 페이지는 자동 삭제되지 않습니다. 로컬 휴지통(.tabple/trash.json) 에 기록만 됩니다. 위키 페이지를 영구 삭제하려면 위키 UI 에서 직접 삭제하세요.
• Callout · Toggle · Columns 같은 블록은 .md 에서는 HTML 주석 메타로 보존됩니다 — 가독성은 떨어지지만 위키로 다시 push 시 원본 블록이 복원됩니다.
• 다이어그램(Mermaid · draw.io) · 데이터베이스 · 임베드(Drive · Figma · YouTube · 동영상) · 첨부 파일 · 수식 · 목차 · 페이지 리스트 같은 블록이 든 페이지는 .md 로 표현할 수 없습니다. 그런 페이지의 .md 를 고쳐도 서버로 보내지 않고 알림만 뜨는데, 보내면 서버에서 그 블록이 지워지기 때문입니다 — 그 페이지는 위키에서 직접 편집하세요.
• 이미지 첨부 (R2 업로드된 이미지) 의 로컬 폴더 다운로드는 추후 지원 예정 — 현재는 절대 URL 그대로 .md 에 들어갑니다.
• 한 폴더는 한 프로젝트에만 매핑됩니다. 다른 프로젝트로 옮기려면 프로젝트 설정 → 폴더 동기화에서 '연결 해제' 후 새로 연결하세요.
• .으로 시작하는 폴더(.git · .obsidian 등), node_modules · dist · build 같은 빌드 폴더, .DS_Store · iCloud 임시 파일은 동기화에서 제외됩니다. 동기화 상태를 저장하는 .tabple 폴더도 대상이 아닙니다 (옛 .taskflow 폴더가 있으면 자동으로 .tabple로 옮겨 이어 씁니다).

다중 디바이스 + 자주 묻는 질문