폴더 동기화 — 로컬 폴더 ↔ 위키 양방향
데스크탑 앱에서 로컬 폴더를 프로젝트와 연결하면 .md 파일과 위키 페이지가 양방향으로 자동 동기화됩니다.
어떤 사용자에게 유용한가
- Obsidian 폴더 — 기존 폴더 그대로 연결, 양방향 sync 시작
- iCloud Drive 의 회의록 폴더 — 모바일/맥에서 적은 노트가 자동으로 Tabple 위키로
- Dropbox 공유 폴더 — 팀원이 폴더에 추가한 .md 가 곧바로 위키 페이지로 등장
- 로컬 백업 — 위키 본문이 항상 .md 파일로 디스크에 보존되어 vendor lock-in 없음
이미 iCloud Drive · Dropbox · Google Drive 같은 클라우드 폴더에 .md 노트를 쌓아두고 있다면, 폴더 동기화로 그 폴더를 Tabple 위키와 통째로 연결할 수 있습니다. Obsidian 사용자는 기존 폴더를 그대로 가리키면 됩니다. 폴더에 파일을 만들면 위키에 페이지가 생기고, 위키에서 편집한 본문은 .md 파일로 다시 저장됩니다. 둘 중 어디에서 작업하든 양쪽이 같은 상태를 유지합니다.
시작하기 (3단계)
데스크탑 앱 설치
폴더 동기화는 데스크탑 앱 전용 기능입니다. 웹/모바일에서는 동작하지 않으니 macOS 또는 Windows 데스크탑 앱을 먼저 설치하세요.
폴더와 연결할 프로젝트 진입
사이드바에서 폴더와 매핑할 프로젝트로 이동합니다. 한 폴더는 한 프로젝트와만 매핑되므로, 새 프로젝트를 만들어 비워두는 방법도 권장됩니다.
프로젝트 설정 → 폴더 동기화 섹션
프로젝트 사이드바 우상단의 ⚙ '프로젝트 설정' 아이콘 클릭 → 페이지 하단의 '폴더 동기화' 섹션에서 '폴더 연결' 버튼을 누르고 폴더를 선택합니다.
4가지 시나리오 자동 분기
- 둘 다 비어있음 — 즉시 sync 시작. 폴더에 .md 만들거나 위키에서 페이지 만들면 자동으로 양쪽에 반영됨.
- 폴더에만 .md 가 있음 — 폴더의 .md 들을 위키로 가져옵니다. 4단계 초과 폴더는 사전 경고 후 sync 에서 제외.
- 위키에만 페이지 있음 — '위키를 폴더로 다운로드' 권장 (양방향 sync 즉시 가능). 또는 '로컬 폴더만 사용' 으로 기존 위키를 무시할 수도 있음.
- 양쪽 모두 콘텐츠 — 정본을 골라야 합니다. 로컬 폴더 정본 (로컬 폴더의 .md 가 위키로) 또는 위키 정본 (위키 본문이 .md 로, 기존 .md 는 .conflict-<날짜>.md 자동 백업).
폴더를 선택하면 시스템이 폴더와 위키 양쪽 상태를 분석해 어떤 시작 방식이 안전한지 알려줍니다. 데이터 손실을 막기 위해 사용자 확인 없이는 어느 쪽도 덮어쓰지 않습니다.
일상 사용 — 무엇이 자동인가
frontmatter 메타 보존
각 .md 파일 첫 줄에 매핑 정보가 자동 기록됩니다. 사용자가 직접 수정할 필요는 없지만, 보존되어야 하는 영역입니다 (없으면 새 페이지로 인식됨).
---
taskflow_id: 1234
title: 회의록 2026-05-08
icon: 📄
---
# 회의록 본문…- Finder/Explorer 에서 .md 파일을 만들면 보통 1~2초 안에 위키 페이지로 등장
- 위키에서 본문을 편집하면 5초 안에 같은 .md 파일이 갱신됨
- 폴더 = 부모 페이지, 하위 폴더 = 자식 페이지 트리로 자동 매핑
- [[페이지명]] 위키 링크는 PageMention chip 으로 자동 변환
- T-123 형식 텍스트는 TaskMention chip 으로 자동 변환
- 체크리스트(- [ ]) · 표 · 코드블록 · 이미지 링크는 round-trip 안전 (로컬 폴더 ↔ 위키 왕복 시 손실 없음)
충돌이 생기면
충돌 모달이 자동으로 뜨는 경우
같은 페이지를 로컬 폴더와 위키에서 동시에 편집해서 어느 쪽도 자동 병합할 수 없을 때 충돌 모달이 자동으로 떠올라 사용자에게 선택을 묻습니다.
로컬을 위키로 올리기
내가 .md 파일에 쓴 내용을 정본으로 채택합니다. 위키 측 변경분은 사라집니다.
위키를 로컬로 받기
위키 본문을 .md 파일에 적용합니다. 로컬 변경분은 사라집니다.
나중에
일단 닫고 다음 충돌 사이클까지 양쪽 다 보존합니다. 다시 sync 가 트리거되면 모달이 다시 뜹니다.
주의사항 & 한계
- Tabple 위키 트리는 4단계 깊이까지만 지원 — 폴더가 5단계 이상이면 그 파일은 sync 에서 제외됩니다 (모달이 사전 안내). 평탄화 예: 회의록/2026/05/08.md → 회의록/2026-05-08.md
- .md 파일을 로컬 폴더에서 삭제해도 위키 페이지는 자동 삭제되지 않습니다. 로컬 휴지통(.taskflow/trash.json) 에 기록만 됩니다. 위키 페이지를 영구 삭제하려면 위키 UI 에서 직접 삭제하세요.
- Callout · Toggle · Columns · Mermaid 같은 풍부 블록은 .md 에서는 HTML 주석 메타로 보존됩니다 — 가독성은 떨어지지만 위키로 다시 push 시 원본 블록이 복원됩니다.
- 이미지 첨부 (R2 업로드된 이미지) 의 로컬 폴더 다운로드는 추후 지원 예정 — 현재는 절대 URL 그대로 .md 에 들어갑니다.
- 한 폴더는 한 프로젝트에만 매핑됩니다. 다른 프로젝트로 옮기려면 Settings → '연결 해제' 후 새로 연결하세요.
다중 디바이스 + 자주 묻는 질문
여러 데스크탑에서 같은 폴더
각 디바이스가 고유한 instance id 로 자기 자신의 push 만 echo 로 무시합니다. 다른 기기의 변경은 정상적으로 pull 됩니다.
오프라인 작업
인터넷이 끊겨도 .md 편집은 그대로 가능합니다. 큐에 push 가 쌓이고, 다시 온라인이 되면 자동으로 비워집니다. 오프라인 동안 위키에서 일어난 변경은 changes-since 로 catch-up.
Q. 폴더 위치 바꾸려면?
프로젝트 설정 → 폴더 동기화 섹션 → '다른 폴더로 변경' 을 누르면 같은 매핑으로 새 위치를 선택할 수 있습니다.
Q. .taskflow/manifest.json 이 손상되면?
자동 복구됩니다. 각 .md 파일의 frontmatter taskflow_id 로 매핑이 다시 만들어지므로, 같은 페이지가 위키에 중복 생성되는 일은 없습니다.
Q. 4단계 초과 폴더는 어떻게 평탄화?
폴더 연결 모달의 사전 경고 list 를 참고해서 폴더 구조를 직접 정리하면 됩니다. 깊이를 줄여 다시 연결하면 sync 대상에 자동 포함됩니다.