#17 로컬 폴더를 연결할 수 있나요?

네 — 게다가 정말 강력해요. 프로젝트 디렉토리를 연결하면 PenPage가 전체 폴더 트리의 라이브 에디터가 돼요. 하위 폴더, 중첩 파일, AI 에이전트 설정 — 전부 양방향으로 자동 동기화돼요.

연결하는 두 가지 방법

  • 아무 폴더나 — 폴더를 우클릭 → Link Directory 로 디스크의 폴더에 연결해요.
  • Directory 워크스페이스 (🗂️) — 로컬 및 네트워크 폴더 전용 워크스페이스로, 다른 노트와 분리되어 있어요. (#6 워크스페이스가 뭐예요?)

둘 다 아래에서 설명하는 동일한 양방향 동기화를 사용해요.

전체 디렉토리 트리 연결

File Link는 파일 하나만 연결하는 게 아니에요 — 디렉토리 전체를 연결하고, 4단계 깊이까지 하위 폴더를 포함해요. 모든 .md 파일이 PenPage 페이지가 돼요. 모든 하위 디렉토리가 중첩된 PenPage 폴더가 돼요.

  1. 폴더의 링크 아이콘을 클릭해요 (또는 우클릭 → 디렉토리 연결)
  2. 컴퓨터에서 디렉토리를 선택해요
  3. PenPage가 트리를 스캔하고 하위 디렉토리 선택기를 보여줘요 — 포함할 하위 폴더를 선택하세요
  4. 끝 — 디렉토리 트리가 PenPage에서 라이브로 연결돼요

한 번 연결로 AI 프로젝트 전체를

여기서부터 재미있어져요. 프로젝트 루트를 연결하면 PenPage가 AI 도구가 사용하는 모든 .md 파일을 자동으로 찾아줘요:

AI 도구 PenPage가 찾아주는 것
Claude Code CLAUDE.md, .claude/agents/, .claude/rules/, .claude/plans/
Gemini CLI GEMINI.md 및 관련 설정
Codex CLI AGENTS.md 및 에이전트 정의

한 번 연결 → 에이전트, 규칙, 계획, 스킬, 프롬프트 — PenPage의 리치 에디터에서 전부 편집 가능. AI가 변경사항을 즉시 읽어요. 복사-붙여넣기도, 창 전환도 없어요.

자세한 편집-실행-동기화 워크플로는 #16 AI 코딩 에이전트를 참고하세요.

양방향 동기화

모든 변경이 양방향으로 동기화돼요 — PenPage에서 디스크로, 디스크에서 PenPage로.

상황 결과
PenPage에서 페이지 편집 디스크의 파일이 자동 업데이트
디스크에서 파일 편집 다음 동기화 때 PenPage에 반영
양쪽 다 변경됨 자동 분기 — 두 버전 생성, 데이터 손실 없음
디스크에서 파일 삭제 페이지가 휴지통으로 이동
PenPage에서 페이지 삭제 디스크의 .md 파일 제거

동기화는 언제 되나요?

  • 페이지 전환: 현재 페이지가 즉시 동기화
  • 탭 포커스: PenPage로 돌아오면 → 연결된 폴더 전부 재스캔
  • 백그라운드: 60초마다 정기 재스캔
  • 수동: 폴더 우클릭 → 디렉토리 동기화

충돌이 나면? PenPage는 어느 쪽도 덮어쓰지 않아요. 양쪽 다 변경되면 두 버전을 만들어요 — 어떤 걸 남길지는 여러분이 결정해요.

AI 프로젝트 모드: PenPage가 .penpage 디렉토리를 감지하면, 충돌 시 파일 쪽이 항상 우선해요 — AI 도구의 결과물이 오래된 PenPage 사본에 덮어쓰이지 않도록요.

Link Update — 새 하위 폴더 발견

연결 후에 프로젝트에 새 디렉토리를 추가했나요? 연결된 폴더를 우클릭 → Link Update. PenPage가 새 하위 디렉토리를 스캔하고 연결할지 물어봐요 — 연결 해제하고 다시 연결할 필요 없어요.

연결 해제

연결을 끊고 싶으면? 폴더를 우클릭 → 디렉토리 연결 해제.

  • 페이지는 PenPage에 그대로 남아요 — 아무것도 삭제되지 않아요
  • 디스크의 파일도 건드리지 않아요
  • 라이브 동기화 연결만 제거돼요
  • 같은 디렉토리를 언제든 다시 연결할 수 있어요

스마트 중복 제거

PenPage는 콘텐츠 해시로 중복을 방지해요:

  • 기존 페이지와 겹치는 디렉토리를 연결? 중복이 감지되고 건너뛰어요
  • 재스캔 시 중복 .md 파일을 자동으로 찾아서 정리해요
  • 빈 .md 파일(편집한 적 없는 페이지)은 자동 제거돼요

브라우저 요구사항

File Link는 File System Access API가 필요해요:

브라우저 지원
Chrome / Edge (데스크톱) 완전 지원 — 권장
Safari / Firefox 미지원
모바일 브라우저 미지원

브라우저가 접근 허용한 디렉토리를 기억해요. 재시작 후에도 PenPage가 조용히 권한을 확인해요 — 대부분 다시 허용 대화상자가 뜨지 않아요.

그냥 노트만 쓰고 싶다면...

File Link는 파워 유저와 개발자를 위한 기능이에요. 그냥 노트를 쓴다면:

  • PenPage 내장 저장소가 더 간단하고 빨라요
  • 여러 기기에서 쓰려면 Cloud 동기화를 사용하세요 (#12)
  • 백업은 한 번 클릭 저장/복원이면 돼요 (#7)

지원하는 파일 형식

.md와 .markdown만 가능해요. 숨김 파일(.로 시작하는 것)은 건너뛰어요.