워크스페이스 관리

VMark에서 워크스페이스는 프로젝트의 루트로 열린 폴더입니다. 워크스페이스를 열면 사이드바에 파일 트리가 표시되고, 빠른 열기가 모든 마크다운 파일을 인덱싱하고, 터미널이 프로젝트 루트에서 시작하고, 열린 탭이 다음 번을 위해 기억됩니다.

워크스페이스 없이도 개별 파일을 열 수 있지만 파일 탐색기, 프로젝트 내 검색, 세션 복원을 사용할 수 없습니다.

워크스페이스 열기

방법	방법
메뉴	파일 > 워크스페이스 열기
빠른 열기	Mod + O, 그런 다음 하단의 찾아보기... 선택
드래그 앤 드롭	Finder에서 마크다운 파일을 창으로 드래그 — VMark가 프로젝트 루트를 감지하고 자동으로 워크스페이스를 엽니다
최근 워크스페이스	파일 > 최근 워크스페이스 에서 이전 프로젝트 선택

워크스페이스를 열면 VMark가 파일 탐색기와 함께 사이드바를 표시합니다. 워크스페이스가 이전에 열렸다면 이전에 열려 있던 탭이 복원됩니다.

TIP

현재 창에 저장되지 않은 변경 사항이 있는 경우 VMark는 작업을 대체하는 대신 새 창에서 워크스페이스를 열도록 제안합니다.

파일 탐색기

파일 탐색기는 워크스페이스가 열려 있을 때마다 사이드바에 나타납니다. 워크스페이스 폴더를 루트로 하는 마크다운 파일 트리를 표시합니다.

탐색

• 폴더를 단일 클릭 하여 확장하거나 축소합니다
• 파일을 더블클릭 하거나 Enter 를 눌러 탭에서 엽니다
• 마크다운이 아닌 파일은 시스템의 기본 응용 프로그램으로 열립니다

파일 작업

파일이나 폴더를 오른쪽 클릭하면 컨텍스트 메뉴에 접근합니다:

동작	설명
열기	새 탭에서 파일 열기
이름 바꾸기	파일 또는 폴더 이름 인라인 편집 (F2도 가능)
복제	파일의 복사본 만들기
이동...	대화상자를 통해 파일을 다른 폴더로 이동
삭제	파일 또는 폴더를 시스템 휴지통으로 이동
경로 복사	절대 파일 경로를 클립보드에 복사
Finder에서 보기	Finder에서 파일 표시 (macOS)
새 파일	이 위치에 새 마크다운 파일 만들기
새 폴더	이 위치에 새 폴더 만들기

또한 트리에서 파일을 폴더 사이로 직접 드래그 앤 드롭 할 수 있습니다.

가시성 토글

기본적으로 탐색기는 마크다운 파일만 표시하고 점 파일을 숨깁니다. 두 가지 토글로 이를 변경합니다:

토글	단축키	기능
숨긴 파일 표시	Mod + Shift + . (macOS) / Ctrl + H (Windows/Linux)	점 파일 및 숨긴 폴더 표시
모든 파일 표시	(설정 또는 컨텍스트 메뉴)	마크다운이 아닌 파일을 문서와 함께 표시

두 설정 모두 워크스페이스별로 저장되며 세션 간에 유지됩니다.

제외된 폴더

특정 폴더는 기본적으로 트리에서 제외됩니다:

• .git
• node_modules

이러한 기본값은 워크스페이스를 처음 열 때 적용됩니다.

빠른 열기

Mod + O를 눌러 빠른 열기 오버레이를 엽니다. 세 가지 소스에서 퍼지 검색을 제공합니다:

1. 이전에 연 최근 파일
2. 현재 창의 열린 탭 (점 표시기로 표시)
3. 워크스페이스의 모든 마크다운 파일

몇 글자를 입력하여 필터링합니다 — 매칭은 퍼지 방식이므로 rme가 README.md를 찾습니다. 화살표 키로 탐색하고 Enter 로 엽니다. 하단의 고정된 찾아보기... 행이 파일 대화상자를 엽니다.

동작	단축키
빠른 열기 열기	Mod + O
결과 탐색	위 / 아래
선택한 파일 열기	Enter
닫기	Escape

TIP

워크스페이스 없이도 빠른 열기는 작동합니다 — 최근 파일과 열린 탭을 표시하지만 파일 트리를 검색할 수 없습니다.

워크스페이스 콘텐츠 검색

워크스페이스가 열려 있을 때 VMark는 마크다운 및 텍스트 파일에서 (파일명뿐 아니라) 파일 콘텐츠 전체를 검색하여 일치하는 항목을 찾을 수 있습니다.

동작	단축키
콘텐츠 검색 패널 열기	Mod + Shift + F
다음 결과로 이동	Enter (또는 화살표 키로 탐색)
결과를 새 탭에서 열기	일치 항목 미리보기 클릭

각 결과에는 파일 경로, 줄 번호, 일치 텍스트가 강조 표시된 스니펫이 표시됩니다. 일치 항목은 다음 기준으로 순위가 매겨집니다:

1. 파일명 관련성 (이름에 검색어가 포함된 파일이 우선)
2. 제목 근접성 (본문 텍스트보다 제목 안의 일치가 먼저)
3. 최신성 (최근에 수정된 파일이 먼저 표시됨)

기본 제외 대상: node_modules/, .git/, dist/, target/, coverage/, 그리고 워크스페이스 설정의 제외된 폴더 에 추가한 모든 디렉터리.

숨긴 파일: 파일 탐색기에서 숨긴 파일 표시 가 활성화되지 않은 한 건너뜁니다.

이는 파일명 만 검색하는 빠른 열기와 다릅니다 — 콘텐츠 검색은 일치하는 줄에 커서를 놓고 일치한 파일을 엽니다.

최근 워크스페이스

VMark는 최근에 열린 워크스페이스를 최대 10개까지 기억합니다. 메뉴 바의 파일 > 최근 워크스페이스 에서 접근합니다.

• 워크스페이스는 마지막으로 열린 시간 순으로 정렬됩니다 (가장 최근 것이 먼저)
• 목록은 모든 변경 시 기본 메뉴와 동기화됩니다
• 최근 워크스페이스 지우기 를 선택하여 목록을 초기화합니다

워크스페이스 설정

각 워크스페이스에는 세션 간에 유지되는 자체 구성이 있습니다. 설정은 프로젝트 폴더 내부가 아닌 VMark 응용 프로그램 데이터 디렉터리에 저장됩니다 — 따라서 워크스페이스가 깨끗하게 유지됩니다.

다음 설정이 워크스페이스별로 저장됩니다:

설정	설명
제외된 폴더	파일 탐색기에서 숨겨진 폴더
숨긴 파일 표시	점 파일이 표시되는지 여부
모든 파일 표시	마크다운이 아닌 파일이 표시되는지 여부
마지막으로 열린 탭	다음 열기 시 세션 복원을 위한 파일 경로

TIP

워크스페이스 구성은 폴더 경로와 연결됩니다. 동일한 기기에서 동일한 폴더를 열면 다른 창에서도 항상 설정이 복원됩니다.

세션 복원

워크스페이스가 열려 있는 창을 닫으면 VMark가 열린 탭 목록을 워크스페이스 구성에 저장합니다. 다음에 동일한 워크스페이스를 열면 해당 탭이 자동으로 복원됩니다.

• 저장된 파일 경로가 있는 탭만 복원됩니다 (제목 없는 탭은 지속되지 않습니다)
• 마지막 세션 이후 파일이 이동되거나 삭제된 경우 자동으로 건너뜁니다
• 세션 데이터는 창을 닫을 때와 워크스페이스를 닫을 때 (파일 > 워크스페이스 닫기) 저장됩니다

멀티 창

각 VMark 창에는 자체 독립 워크스페이스가 있을 수 있습니다. 이를 통해 여러 프로젝트를 동시에 작업할 수 있습니다.

• 파일 > 새 창 으로 새 창을 엽니다
• 새 창에서 워크스페이스를 열면 다른 창에 영향을 미치지 않습니다
• 창 크기와 위치가 창별로 기억됩니다

Finder에서 마크다운 파일을 드래그할 때 현재 창에 저장되지 않은 작업이 있으면 VMark가 자동으로 새 창에서 파일의 프로젝트를 엽니다.

탭을 새 창으로 분리

탭을 창에서 꺼내 새 창을 만들 수 있습니다:

• 탭을 아래로 드래그 하여 탭 바를 넘으면 (약 40px) 커서 위치에 새 창으로 분리됩니다
• 탭을 수평으로 드래그 하여 탭 바 내에서 다른 탭 사이의 순서를 변경합니다
• 고정된 탭은 드래그할 수 없습니다

제스처는 방향이 고정됩니다: 수평 이동은 재정렬을 시작하고, 수직 이동은 분리를 트리거합니다. 드래그 중에 포인터를 탭 바 밖으로 이동하면 재정렬에서 분리로 전환할 수 있습니다.

외부 변경 사항

VMark는 다른 프로그램(Git, 외부 편집기, 빌드 도구 등)에 의한 워크스페이스 변경 사항을 모니터링하고 열린 문서를 동기화 상태로 유지합니다.

• 수정되지 않은 파일 은 디스크의 내용이 변경되면 자동으로 다시 로드됩니다. 간단한 토스트 알림이 다시 로드를 확인합니다.
• 저장되지 않은 변경 사항이 있는 파일 은 세 가지 옵션이 있는 프롬프트 대화상자를 표시합니다: 다른 이름으로 저장 (새 위치에 저장), 다시 로드 (변경 사항을 버리고 디스크에서 로드), 또는 유지 (편집 내용을 보존하고 파일을 분기 상태로 표시).
• 삭제된 파일 은 탭에서 누락으로 표시되지만 닫히지 않습니다 — 내용을 새 위치에 저장할 수 있습니다.
• 여러 수정된 파일이 동시에 변경되는 경우 (예: git checkout 후), VMark는 이를 하나의 대화상자로 묶어 모두 다시 로드, 모두 유지 또는 각 파일을 개별적으로 검토할 수 있게 합니다.
• 분기된 파일의 디스크 내용이 나중에 에디터의 내용과 일치하면 (예: git checkout이 동일한 텍스트를 복원), VMark는 자동으로 분기 상태를 지워 정상적인 자동 저장이 재개됩니다.

VMark는 자체 저장을 필터링하므로 앱 내에서 수행한 변경 사항에 대해 프롬프트가 표시되지 않습니다.

macOS Dock 최근 문서

VMark에서 열 문서는 macOS에 등록되어 Dock에서 VMark 아이콘을 오른쪽 클릭하면 최근 사용 항목 열기 하위 메뉴에 나타납니다.

터미널 통합

통합 터미널은 자동으로 워크스페이스 루트를 작업 디렉터리로 사용합니다. 워크스페이스를 열거나 전환하면 모든 터미널 세션이 새 루트로 cd합니다.

VMARK_WORKSPACE 환경 변수는 모든 터미널 세션에서 워크스페이스 경로로 설정되어 스크립트가 프로젝트 루트를 참조할 수 있습니다.

터미널에 대해 자세히 알아보기 →

셸 CLI 명령어

VMark는 vmark 셸 명령어를 설치하여 터미널에서 파일과 폴더를 열 수 있게 합니다.

설치

도움말 > 'vmark' 명령어 설치 로 이동합니다. VMark는 /usr/local/bin/vmark에 작은 런처 스크립트를 작성하고 관리자 비밀번호를 요청합니다 (VS Code가 code 명령어에 사용하는 것과 동일한 방식입니다).

사용법

# 파일 열기
vmark README.md

# 폴더를 워크스페이스로 열기
vmark ~/projects/my-blog

# 여러 파일 열기
vmark chapter1.md chapter2.md

명령어는 open -b app.vmark에 위임하므로 macOS가 단일 인스턴스 동작을 처리합니다 — 파일은 새 프로세스를 시작하는 대신 기존 VMark 창에서 열립니다.

제거

도움말 > 'vmark' 명령어 제거 로 이동하여 /usr/local/bin/vmark를 삭제합니다. 해당 경로의 파일이 VMark에 의해 설치된 것이 아닌 경우, 작업이 차단되고 수동으로 제거하도록 요청합니다.