OV 사용자 가이드
OV의 주요 기능을 한 번에 훑어볼 수 있는 사용자 매뉴얼입니다. 앱 안에서도 동일한 가이드를 우측 레일 ? 버튼 → “외부 문서” 또는 사이드바의 starter 노트(Welcome, 단축키, 마크다운, 캘린더, 보안)에서 볼 수 있어요.
이 페이지의 목차
1. Vault — 노트를 저장하는 폴더
OV의 모든 노트는 로컬 마크다운 파일입니다. Vault는 그 파일들이 모여 있는 폴더 한 개를 가리켜요.
- 기본 vault: 첫 실행 시
~/Documents/OV폴더가 자동 생성됩니다. - 다른 vault 열기: 좌측 사이드바(📁) → “Vault 열기” → 임의의 폴더 선택.
- 여러 vault 사용: 한 번에 하나의 vault만 열 수 있지만, 자유롭게 전환할 수 있습니다.
- 호환성: 같은 폴더를 Obsidian, iA Writer, VS Code 등에서도 열어 작업할 수 있어요. 변경하면 OV 쪽에서 자동 새로고침됩니다.
저장 안전성:
- 모든 쓰기는 atomic (tmp + rename) — 저장 도중 크래시나 정전이 발생해도 파일이 손상되지 않습니다.
- 외부 편집기가 파일을 동시에 수정하면 mtime 충돌 감지 모달이 떠서 덮어쓸지 / 외부 변경을 불러올지 선택할 수 있어요.
- 종료 시 저장하지 않은 변경이 있으면 확인 다이얼로그가 뜹니다.
2. 마크다운 작성
빈 줄에서 자동 변환되는 입력 규칙:
| 입력 | 결과 |
|---|---|
# |
큰 제목 (H1) |
## |
중간 제목 (H2) |
### |
작은 제목 (H3) |
- |
글머리 기호 목록 |
1. |
번호 목록 |
- [ ] |
할 일 체크박스 |
> |
인용문 |
| ` ``` ` | 코드 블록 |
--- |
가로 구분선 |
인라인 마크다운: **굵게**, *기울임*, ~~취소선~~, `코드`, [링크](url), [[위키링크]].
슬래시 메뉴(/): 빈 줄에서 / 입력 → 모든 블록 타입을 메뉴에서 선택. 마크다운을 외우기 싫다면 슬래시가 답입니다.
Callout 색상 의미:
- 🔴 빨강 (
Callout · 빨강) — 강조 / 위험 - 🟦 청록 (
Callout · 청록) — 정보 - 🟡 노랑 (
Callout · 노랑) — 경고 - 🟢 초록 (
Callout · 초록) — 성공 / 확인 - ⚪ 회색 (
Callout · 회색) — 보조 메모
3. 노트 속성 (Frontmatter)
노트 상단의 회색 영역에서 + Add a property를 클릭해 메타데이터를 추가할 수 있어요. 마크다운 파일 맨 위에 YAML frontmatter로 저장됩니다.
지원 타입: Text, Date, Tags(다중), Checkbox, Number.
이 속성은 데이터베이스 뷰(⌘2)에서 자동으로 컬럼이 되고, Kanban에서 그룹키로 쓸 수 있고, 캘린더에서 date 속성을 가진 노트들이 표시됩니다.
4. 데이터베이스 뷰 (⌘2)
- Table: 노트 목록 + 정렬 + 필터. 필터 입력으로 빠르게 좁힐 수 있어요.
- Kanban (보드):
Group by로 선택한 속성으로 카드를 열 단위로 묶음. 카드를 드래그해서 다른 열로 이동하면 속성 값이 자동으로 바뀝니다.
5. 캘린더 & 일정
좌측 캘린더 아이콘(📅) 클릭:
- Month view: 한 달치 그리드. 날짜 클릭 → 그 날의 일정 패널.
- Day view: 시간 슬롯이 있는 하루 뷰. NOW 라인이 현재 시각을 보여줍니다.
일정 추가: 날짜 선택 → + Add to schedule → 제목 + 시간(14:00 또는 14:00-15:30) + 설명 → 저장. Schedule/ 폴더 안에 노트로 저장됩니다.
Schedule/의 노트는 일반 노트와 똑같이 편집 가능. frontmatter의 date와 time 필드를 직접 고쳐도 됩니다.
6. AI Copilot (⌘J)
우측 패널에서 AI 어시스턴트를 띄울 수 있어요.
설정:
- 설정(
⌘,) → AI Copilot 탭 - OpenAI API 키 입력 → “저장” → 키체인(macOS Keychain / Windows DPAPI / Linux libsecret)에 암호화 저장됩니다.
키는 OV 서버를 거치지 않고 OpenAI로 직접 호출됩니다. 로컬에 평문으로 남지 않아요.
기능:
- 요약·이어쓰기·정리 같은 자연어 명령
- vault를 읽는 도구(list/read/search) + 변경을 제안하는 도구(create/edit) — 모든 변경은 diff로 표시되고 사용자가 직접 Approve해야 적용됩니다.
- “오늘”, “내일”, “어제” 같은 단어는 intent router가 자동 인식해 캘린더에서 미리 데이터를 가져옵니다.
단축키:
⌘J— 열기/닫기⌘↵— 메시지 전송
7. 보안
앱 비밀번호
앱 시작 시 비밀번호를 요구하도록 설정할 수 있어요. 설정 → Security 탭 → App password.
파일 비밀번호
개별 노트를 잠글 수 있어요.
- 설정에서 File password 등록
- 사이드바에서 노트 우클릭 → “잠금” → AES-GCM-256으로 암호화
- 잠금 해제: 노트 클릭 → 비밀번호 입력 (세션 동안 캐시)
암호화 알고리즘: PBKDF2-SHA256 (200k iterations) + AES-GCM-256. WebCrypto API 사용. 평문 비밀번호는 메모리에만 존재합니다.
8. 단축키 모음
전체 단축키는 앱 안에서 ⌘/ 로 띄울 수 있고, SHORTCUTS.md에 정적 버전이 있어요.
핵심 5개만:
⌘K— 명령 팔레트⌘P— 파일 빠른 점프⌘J— AI Copilot⌘D— 오늘의 노트⌘/— 단축키 시트 (이 시트)
9. 첨부파일
이미지·동영상·일반 파일을 노트에 첨부할 수 있어요.
- 드래그 & 드롭: 에디터에 파일을 끌어다 놓으면 자동 첨부
- 붙여넣기: 클립보드의 이미지를
⌘V로 붙여넣기 - 슬래시 메뉴:
/이미지,/동영상,/파일 - 임베드:
/임베드→ YouTube/Vimeo URL 입력 → iframe으로 임베드
첨부파일은 vault 안의 .attachments/ 폴더에 저장됩니다.
10. 도움이 필요할 때
?버튼 (우측 레일) — 도움말 메뉴 + 가이드 노트로 이동⌘/— 단축키 시트- 사이드바 starter 노트 —
Welcome,단축키,마크다운,캘린더,보안 - SHORTCUTS.md — 단축키 전체
- COLORS.md — 색상 토큰 의미
- CHANGELOG.md — 버전별 변경 내역