# 노트

연구 노트를 내 컴퓨터에 Markdown 파일로 보관하고, 노트 홈에서 찾고, 빠른 캡처로 아이디어를 바로 적습니다.

노트는 리치 편집기로 쓰는 Markdown 파일입니다. 제목, 할 일, 표, 수식, 이미지는 물론 차트와 다이어그램 같은 그려지는 블록도 넣을 수 있고, 다른 노트와 내 프로젝트로 링크할 수도 있습니다. 노트 하나하나가 내 컴퓨터의 평범한 파일이라서 백업하거나 다른 편집기에서 열 수 있습니다.

노트는 실험 기능이라서 켜기 전에는 꺼져 있습니다. **설정 → 실험 기능**의 모든 스위치와 마찬가지로 베타이며, 이후 릴리스에서 바뀌거나 사라질 수 있습니다.

## 노트 켜기

1. **설정 → 실험 기능**을 엽니다.
2. **노트**를 켭니다.

![설정 → 실험 기능에서 노트 스위치가 켜져 있고, 위에는 이 기능들이 아직 베타라는 경고가 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-experimentation-dark-window-v2.png#view=424,136,1072,680)

노트를 켜면 다음과 같이 달라집니다.

- [홈 독](/docs/library/#the-home-dock)에 **노트** 버튼이 생깁니다. 명령 팔레트(⌘K, Windows와 Linux에서는 Ctrl+K)에는 **노트 열기**와 **빠른 캡처**가 생깁니다.
- 프로젝트 창마다 측면 레일에 **노트** 패널이 생깁니다. [프로젝트 노트와 공유 노트](/docs/notes/projects-and-sharing/)를 참고하세요.
- **설정 → 모양**과 **설정 → 키보드 단축키**에 각각 **노트** 탭이 생깁니다.

노트를 켜 두는 동안 노트는 프로젝트 라이브러리에 나타나지 않습니다. 노트를 끄면 라이브러리에 Markdown 프로젝트로 다시 나타납니다. 어느 쪽이든 아무것도 삭제되지 않습니다.

## 노트 작업 공간

홈 독에서 **노트**를 선택하거나 명령 팔레트에서 **노트 열기**를 실행하세요. 노트가 창 전체를 채웁니다. 왼쪽 사이드바에 노트가 나열되고, 창의 나머지에는 탭이 놓입니다. 노트는 각각 탭 하나로 열리며, 탭을 패널 가장자리로 끌면 보기가 분할됩니다.

![노트가 창 전체를 채웁니다. 사이드바에는 노트와 연결된 각 프로젝트 아래에 노트가 묶여 있고, Long-context LLMs: thesis hub 노트가 탭으로 열려 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-workspace-dark-window-v2.png)

노트를 처음 열면 이미 노트가 하나 들어 있습니다. **블록 갤러리**라는 노트로, 노트에 넣을 수 있는 거의 모든 블록의 예시가 담겨 있습니다.

### 사이드바

사이드바에는 노트가 연결된 프로젝트별로 묶여 나열됩니다. [노트 찾기와 정리](/docs/notes/organize/#the-sidebar)에서 사이드바의 각 부분을 차례로 설명하고, [노트 검색](/docs/notes/organize/#search-notes)에서 `tag:lab`, `project:thesis`, `is:favorite` 같은 한정자를 설명합니다.

### 노트 홈

노트 홈에는 내 노트가 나열됩니다. **홈** 탭에서 열립니다. 노트의 탭 안에 노트 홈을 표시하려면 노트의 이동 경로 표시줄 맨 앞에 있는 집 모양, **노트 홈**을 선택하세요. 구성은 **내 노트**, **즐겨찾기**, **할 일**, **첨부 파일**입니다.

![노트 홈의 내 노트 탭에는 노트가 미리보기가 있는 카드로 마지막으로 연 날짜 순으로 나열되고, 옆에 즐겨찾기, 할 일, 첨부 파일 탭이 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-home-dark-window-v2.png#view=350,0,1570,1040)

아직 노트가 없으면 노트 홈에 빈 노트 타일과 연구 템플릿 여덟 개의 타일이 나타나고, 그 아래에 **Markdown 가져오기**와 **템플릿 더 보기**가 있습니다.

보기와 정렬은 [노트 홈](/docs/notes/organize/#notes-home)에, 할 일과 첨부 파일 필터는 [할 일](/docs/notes/organize/#tasks)과 [첨부 파일](/docs/notes/organize/#attachments)에 있습니다.

## 노트 만들기

- **새 노트**(⌘⌥N, Windows와 Linux에서는 Ctrl+Shift+N)는 빈 노트를 만들어 엽니다.
- **오늘의 노트**(⌘⇧D 또는 Ctrl+Shift+D)는 `2026-11-12`처럼 오늘 날짜를 제목으로 한 노트를 열고, 아직 없으면 **데일리 노트** 템플릿으로 시작합니다. 제목 형식, 템플릿, 태그는 [노트 모양](#notes-appearance)의 **데일리, 주간, 월간 노트**에서 정합니다.
- **노트로 이동**(⌘O 또는 Ctrl+O)은 제목이나 별칭으로 노트를 찾습니다. 입력한 제목과 정확히 일치하는 노트가 없으면 **“…” 노트 만들기**를 제안합니다.

노트의 모든 키는 [키보드 단축키](/docs/keyboard-shortcuts/#notes)에 나와 있습니다. 키는 **설정 → 키보드 단축키**의 **노트** 탭에서 바꿀 수 있습니다.

### 템플릿으로 시작하기

사이드바 막대의 **템플릿으로 새로 만들기**를 선택하면 템플릿 선택기가 열립니다. 템플릿 타일 아래의 **템플릿 더 보기**로도 열립니다. 선택기에는 **빈 노트**와 세 그룹이 있습니다.

- **연구 템플릿**에는 시작용 노트 13개가 있습니다. **데일리 노트**, **실험 기록**, **논문 읽기 노트**, **문헌 검토 매트릭스**, **회의록**, **실험 프로토콜**, **주간 연구 기록**, **연구 제안서**, **증명 또는 유도**, **데이터 분석 보고서**, **인터뷰 노트**, **스크리닝 기록**, **실험 노트 기록**입니다. 템플릿마다 고유한 제목, 속성, 태그가 미리 채워집니다.
- **내 템플릿**에는 노트 메뉴에서 **템플릿으로 사용**을 선택한 모든 노트가 나열됩니다. 그중 하나로 노트를 시작하면 제목과 본문의 `{{title}}`, `{{date}}`, `{{time}}`, `{{weekday}}`가 채워집니다.
- **참고문헌에서**에는 입력한 내용과 일치하는 항목이 나열됩니다. 제목의 일부, 저자, 인용 키가 해당합니다. 열려 있는 프로젝트의 참고문헌과, [Zotero를 연결](/docs/citations/#cite-from-your-zotero-library)했다면 Zotero 라이브러리에서 가져옵니다. 항목을 고르면 그 참고문헌의 정보가 채워진 **논문 읽기 노트** 노트가 시작됩니다. 그 인용 키의 노트가 이미 있으면 Oleafly가 그 노트를 엽니다.

![템플릿 선택기에는 템플릿 찾기 상자가 있고, 그 아래에 빈 노트와 연구 템플릿이 나열되며 데일리 노트, 실험 기록, 논문 읽기 노트가 맨 앞에 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-templates-dark-window-v2.png#view=668,184,584,518)

### Markdown 파일 가져오기

이미 가진 노트를 가져오려면 사이드바 막대에서 **더 보기 → Markdown 가져오기**를 선택한 다음 **폴더 선택** 또는 **파일 선택**을 고르세요.

- `.md` 파일 하나가 노트 하나가 됩니다.
- 파일 사이의 링크는 노트 사이의 링크가 되고, 링크된 파일은 첨부 파일로 복사됩니다. 어떤 파일과도 일치하지 않는 링크는 일반 텍스트로 남습니다.
- 5 MB보다 큰 파일은 건너뜁니다.
- **폴더 이름을 태그로 추가**는 각 노트에 해당 폴더를 태그로 붙입니다. `Lab/2024`에 있는 파일에는 `Lab/2024` 태그가 붙습니다.

폴더에 노트가 1,000개를 넘거나 같은 폴더를 전에 가져온 적이 있으면 Oleafly가 먼저 확인을 요청합니다. **가져오기 중지**는 가져오기를 언제든 끝내며, 중지한 가져오기는 노트를 하나도 추가하지 않습니다.

## 빠른 캡처

빠른 캡처는 지금 쓰던 앱을 벗어나지 않고 생각을 적어 두는 작은 창입니다. 다른 창 위에 계속 떠 있습니다.

### 빠른 캡처 열기

macOS에서는 ⌘⇧⌥Space, Windows와 Linux에서는 Ctrl+Shift+Alt+Space를 누르거나 명령 팔레트에서 **빠른 캡처**를 실행하세요. Oleafly가 실행 중이면 창이 백그라운드에 있어도 이 단축키는 어떤 앱에서든 작동합니다.

![빠른 캡처가 작은 창으로 열려 쓴 텍스트와 첫 줄에서 가져온 제목이 보이고, 오른쪽 위에 동작, 노트 열기, 새 노트 버튼이 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-quick-capture-dark-window-v2.png)

키를 바꾸려면 **설정 → 키보드 단축키**의 **노트** 탭에서 **노트: 빠른 캡처**를 편집하세요. 목록 아래의 **어디서나 빠른 캡처** 스위치는 이 단축키를 끕니다. 다른 앱이 이미 그 키를 쓰고 있으면 설정이 알려 주며, 다른 단축키를 고를 수 있습니다.

Wayland를 쓰는 Linux 데스크톱에서는 앱이 자기 창 밖의 키 입력을 감지할 수 없어서 이 스위치를 쓸 수 없습니다. 대신 설정이 명령을 보여 줍니다. 데스크톱의 키보드 설정에서 이 명령을 실행하는 사용자 지정 단축키를 추가하세요. Oleafly가 실행 중이 아니면 명령이 Oleafly를 시작한 뒤 빠른 캡처를 엽니다.

### 쓰고 저장하기

빈 줄에 `/`를 입력하면 제목, 목록 등 여러 블록이 나오고, **서식 표시**를 선택하면 서식 막대가 나타납니다. 맨 위의 제목은 첫 줄에서 가져옵니다. 창 위로 포인터를 옮기면 버튼이 나타납니다.

| macOS | Windows / Linux | 동작 |
|---|---|---|
| ⌘↵ | Ctrl+Enter | 새 노트로 저장 |
| ⌘⇧↵ | Ctrl+Shift+Enter | 오늘의 노트에 추가 |
| ⌘K | Ctrl+K | **동작** 메뉴 열기 |
| Esc | Esc | 창 닫기 |

- **새 노트로 저장**은 쓴 내용을 첫 줄을 제목으로 한 노트로 노트에 저장하고 창을 닫습니다. 이 노트는 프로젝트에 연결되지 않으므로 사이드바의 **노트** 아래에 나타납니다.
- **오늘의 노트에 추가**는 쓴 내용을 오늘의 노트 끝에 추가하며, 노트가 아직 없으면 먼저 **데일리 노트** 템플릿으로 시작합니다. 데일리 노트가 켜져 있는 동안 제공됩니다.
- **동작** 메뉴에는 이 두 가지와 함께 **Markdown으로 복사**와 **초안 삭제**가 있습니다.
- 더하기 버튼인 **새 노트**는 쓴 내용을 노트로 저장하고, 창은 다음 노트를 위해 비운 채 열어 둡니다.
- **노트 열기**는 기본 창에서 노트를 엽니다.

![빠른 캡처의 동작 메뉴에 새 노트로 저장과 오늘의 노트에 추가가 단축키와 함께 있고, 그 아래에 Markdown으로 복사와 초안 삭제가 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-quick-capture-actions-dark-window-v2.png)

창을 닫아도 초안은 남아 있으므로 다음에 빠른 캡처를 열면 그대로 있습니다. 저장에 실패하면 창이 알려 주고 텍스트를 그대로 둬서 다시 시도할 수 있습니다.

## 노트가 저장되는 위치

개인 노트는 프로젝트에 저장되지 않은 노트입니다. 개인 노트는 각각 Oleafly의 프로젝트 폴더 안에, 내 프로젝트 옆에 폴더로 저장됩니다.

| 시스템 | 폴더 |
| --- | --- |
| Windows | `C:\Users\<you>\.oleafly\projects` |
| macOS | `/Users/<you>/.oleafly/projects` |
| Linux | `/home/<you>/.oleafly/projects` |

여기서 `<you>`는 사용자 이름입니다. 노트 폴더에는 노트 제목이 아니라 `swift-teal-otter` 같은 무작위 이름이 붙습니다. 프로젝트 폴더를 열려면 **설정 → 데이터 저장 → 로컬 저장소**에서 경로 옆의 버튼을 사용하세요. [프로젝트 폴더](/docs/settings/storage/#projects-folder)를 참고하세요.

노트 폴더에는 다음이 들어 있습니다.

- `note.md`: 노트 자체입니다.
- `project.json`: 노트의 이름과 연결된 프로젝트가 들어 있습니다.
- `assets`: 노트에 추가한 이미지와 파일을 담는 폴더입니다. 노트는 `assets/`로 시작하는 경로로 이 파일들을 링크합니다.

프로젝트에 속한 노트는 대신 그 프로젝트의 `notes` 폴더에 있는 `.md` 파일입니다. [프로젝트 노트와 공유 노트](/docs/notes/projects-and-sharing/)를 참고하세요.

[클라우드 동기화](/docs/cloud-sync/)는 라이브러리 프로젝트와 함께 개인 노트도 백업하며, 프로젝트 목록에서 이 노트에 **노트** 태그가 붙습니다. 두 컴퓨터에서 동기화되기 전에 노트가 바뀐 경우, 사이드바와 노트 홈에서 노트 옆에 "이 노트에 충돌 사본이 있습니다"라고 알려 주는 아이콘이 표시됩니다. 노트 메뉴에서 **충돌 사본 비교**를 선택해 차이를 확인한 다음 **이 컴퓨터의 버전 유지** 또는 **다른 컴퓨터의 버전 사용**을 선택하세요. 다른 버전은 삭제됩니다.

### 노트 파일의 모습

노트는 맨 위에 YAML 앞부분 메타데이터(front matter)가 있는 일반 Markdown입니다. Oleafly는 다음 필드를 씁니다.

| 필드 | 담는 내용 |
| --- | --- |
| `title` | 노트의 제목 |
| `agent` | 에이전트가 노트를 썼을 때 그 에이전트의 이름 |
| `icon` | 노트의 아이콘 |
| `color` | `mint` 같은 노트의 색상 |
| `kind` | `note`. 이 파일이 노트임을 나타냅니다 |
| `id` | 다른 노트의 링크가 이 노트를 찾는 데 쓰는 ID |

직접 만든 속성은 `tags`, `aliases`와 함께 같은 블록에 들어갑니다. 템플릿으로 쓰는 노트에는 `template: true`도 있습니다. 노트 파일은 다음과 같은 모습일 수 있습니다.

```markdown
---
title: Field notes
color: mint
kind: note
id: 0b7f2c9e-5d1a-4e8b-9c3f-2a6d8e1f4b70
tags: [fieldwork]
---

## Morning survey

Light rain until nine, then clear skies over the north ridge.

- [ ] Upload the photos
```

### 다른 프로그램에서 노트 편집하기

Oleafly가 실행 중이어도 `note.md`를 아무 텍스트 편집기에서 열 수 있습니다. 노트가 Oleafly에서 열려 있으면 다른 프로그램에서 한 변경이 그 노트에 변경 제안으로 나타나며, 노트에서 수락하거나 거부하면 됩니다. 아직 저장하지 않은 내 편집이 있었다면 Oleafly가 둘을 병합합니다. 노트로 오는 링크가 이 값을 쓰므로 `id` 줄은 그대로 두세요.

노트를 Markdown 파일 폴더로 Oleafly 밖으로 가져가려면 사이드바 막대에서 **더 보기 → Markdown 폴더로 내보내기**를 선택하세요. 열려 있는 노트 또는 모든 노트가 첨부 파일과 함께 `attachments` 폴더에 저장됩니다. 노트 하나를 Word 문서, 웹 페이지, LaTeX, Typst로 저장하려면 [노트 내보내기](/docs/notes/writing/#export-a-note)를 참고하세요.

### 노트 삭제하기

노트 메뉴에서 **삭제**를 선택한 다음 **휴지통으로 이동**을 선택하세요. 노트는 노트에서 사라지고, 노트 폴더는 **설정 → 데이터 저장 → 로컬 저장소**의 휴지통으로 갑니다. 거기서 노트 옆의 **복원**을 선택하면 되돌릴 수 있습니다. [휴지통](/docs/settings/storage/#recycle-bin)을 참고하세요.

## 노트 모양

**설정 → 모양 → 노트**를 열거나 노트 사이드바 맨 아래의 **설정**을 선택하세요. 이 탭은 노트가 켜져 있는 동안에만 있습니다. 설정 옆에, 설정 창이 좁으면 설정 위에 샘플 노트가 놓여 변경 내용을 바로 보여 줍니다.

![설정 → 모양 → 노트의 왼쪽에는 서체, 노트 글꼴, 노트 글자 크기, 노트 줄 높이, 문단 간격이 있고, 오른쪽에는 Field notes 샘플이 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-notes-appearance-dark-window-v2.png#view=252,136,1416,928)

| 그룹 | 설정하는 것 |
| --- | --- |
| **텍스트** | **서체**(**산세리프**, **세리프**, **고정폭**), 설치된 모든 글꼴을 쓸 수 있는 **노트 글꼴**, **노트 글자 크기**, **노트 줄 높이**, **문단 간격** |
| **제목과 노트 제목** | **제목 서체**, **제목 글꼴**, **제목 크기**, **노트 제목 크기** |
| **레이아웃** | **노트 너비**, **노트 정보**가 놓일 위치(**사이드 패널** 또는 **인라인**), **할 일 체크박스**(**사각형** 또는 **원형**), **단어 수 표시**, **노트 맞춤법 검사**, 쌍 목록이 있는 **입력하면서 바꾸기**, **닫은 뒤에도 실행 취소 유지** |
| **코드** | **코드 글꼴**과 **코드 블록 색상** |
| **LaTeX 그림** | 모든 TikZ 및 CircuiTikZ 블록의 시작 부분이 되는 **TikZ 프리앰블** |
| **색상** | **노트 강조 색상**, **콜아웃 스타일**, **날짜와 필드 칩**의 모양 |
| **웹 이미지** | 먼저 묻지 않고 이미지를 불러오는 사이트 |
| **데일리, 주간, 월간 노트** | **주 시작 요일**, 그리고 노트 종류마다 제목 형식, 템플릿, 태그와 그 종류를 끄는 스위치 |

바꾼 설정에는 해당 행에 초기화 버튼이 나타납니다. 모양 맨 아래의 **기본값으로 초기화**는 [기본값으로 초기화](/docs/settings/appearance/#reset-to-defaults)에 설명된 대로 모양의 나머지와 함께 노트 설정도 초기화합니다. **웹 이미지** 아래의 사이트는 그대로 둡니다. 사이트를 제거하려면 그 옆의 버튼을 사용하세요.

## 다음으로 볼 내용

- [노트에 쓰기](/docs/notes/writing/): 편집기, 블록, 링크, 첨부 파일.
- [노트 찾기와 정리](/docs/notes/organize/): 검색, 태그, 할 일, 데일리 노트, 그래프.
- [프로젝트 노트와 공유 노트](/docs/notes/projects-and-sharing/): 노트를 프로젝트에 연결하기, 프로젝트 노트, 다른 사람과 함께 노트 쓰기, 읽기 전용 사본 게시하기.
- [AI와 함께 쓰는 노트](/docs/notes/ai/): 노트에 대해 어시스턴트나 CLI 에이전트에게 묻고 제안을 검토하기.
