노트
연구 노트를 내 컴퓨터에 Markdown 파일로 보관하고, 노트 홈에서 찾고, 빠른 캡처로 아이디어를 바로 적습니다.
노트는 리치 편집기로 쓰는 Markdown 파일입니다. 제목, 할 일, 표, 수식, 이미지는 물론 차트와 다이어그램 같은 그려지는 블록도 넣을 수 있고, 다른 노트와 내 프로젝트로 링크할 수도 있습니다. 노트 하나하나가 내 컴퓨터의 평범한 파일이라서 백업하거나 다른 편집기에서 열 수 있습니다.
노트는 실험 기능이라서 켜기 전에는 꺼져 있습니다. 설정 → 실험 기능의 모든 스위치와 마찬가지로 베타이며, 이후 릴리스에서 바뀌거나 사라질 수 있습니다.
노트 켜기
섹션 제목: “노트 켜기”- 설정 → 실험 기능을 엽니다.
- 노트를 켭니다.

노트를 켜면 다음과 같이 달라집니다.
- 홈 독에 노트 버튼이 생깁니다. 명령 팔레트(⌘K, Windows와 Linux에서는 Ctrl+K)에는 노트 열기와 빠른 캡처가 생깁니다.
- 프로젝트 창마다 측면 레일에 노트 패널이 생깁니다. 프로젝트 노트와 공유 노트를 참고하세요.
- 설정 → 모양과 설정 → 키보드 단축키에 각각 노트 탭이 생깁니다.
노트를 켜 두는 동안 노트는 프로젝트 라이브러리에 나타나지 않습니다. 노트를 끄면 라이브러리에 Markdown 프로젝트로 다시 나타납니다. 어느 쪽이든 아무것도 삭제되지 않습니다.
노트 작업 공간
섹션 제목: “노트 작업 공간”홈 독에서 노트를 선택하거나 명령 팔레트에서 노트 열기를 실행하세요. 노트가 창 전체를 채웁니다. 왼쪽 사이드바에 노트가 나열되고, 창의 나머지에는 탭이 놓입니다. 노트는 각각 탭 하나로 열리며, 탭을 패널 가장자리로 끌면 보기가 분할됩니다.

노트를 처음 열면 이미 노트가 하나 들어 있습니다. 블록 갤러리라는 노트로, 노트에 넣을 수 있는 거의 모든 블록의 예시가 담겨 있습니다.
사이드바
섹션 제목: “사이드바”사이드바에는 노트가 연결된 프로젝트별로 묶여 나열됩니다. 노트 찾기와 정리에서 사이드바의 각 부분을 차례로 설명하고, 노트 검색에서 tag:lab, project:thesis, is:favorite 같은 한정자를 설명합니다.
노트 홈
섹션 제목: “노트 홈”노트 홈에는 내 노트가 나열됩니다. 홈 탭에서 열립니다. 노트의 탭 안에 노트 홈을 표시하려면 노트의 이동 경로 표시줄 맨 앞에 있는 집 모양, 노트 홈을 선택하세요. 구성은 내 노트, 즐겨찾기, 할 일, 첨부 파일입니다.

아직 노트가 없으면 노트 홈에 빈 노트 타일과 연구 템플릿 여덟 개의 타일이 나타나고, 그 아래에 Markdown 가져오기와 템플릿 더 보기가 있습니다.
보기와 정렬은 노트 홈에, 할 일과 첨부 파일 필터는 할 일과 첨부 파일에 있습니다.
노트 만들기
섹션 제목: “노트 만들기”- 새 노트(⌘⌥N, Windows와 Linux에서는 Ctrl+Shift+N)는 빈 노트를 만들어 엽니다.
- 오늘의 노트(⌘⇧D 또는 Ctrl+Shift+D)는
2026-11-12처럼 오늘 날짜를 제목으로 한 노트를 열고, 아직 없으면 데일리 노트 템플릿으로 시작합니다. 제목 형식, 템플릿, 태그는 노트 모양의 데일리, 주간, 월간 노트에서 정합니다. - 노트로 이동(⌘O 또는 Ctrl+O)은 제목이나 별칭으로 노트를 찾습니다. 입력한 제목과 정확히 일치하는 노트가 없으면 “…” 노트 만들기를 제안합니다.
노트의 모든 키는 키보드 단축키에 나와 있습니다. 키는 설정 → 키보드 단축키의 노트 탭에서 바꿀 수 있습니다.
템플릿으로 시작하기
섹션 제목: “템플릿으로 시작하기”사이드바 막대의 템플릿으로 새로 만들기를 선택하면 템플릿 선택기가 열립니다. 템플릿 타일 아래의 템플릿 더 보기로도 열립니다. 선택기에는 빈 노트와 세 그룹이 있습니다.
- 연구 템플릿에는 시작용 노트 13개가 있습니다. 데일리 노트, 실험 기록, 논문 읽기 노트, 문헌 검토 매트릭스, 회의록, 실험 프로토콜, 주간 연구 기록, 연구 제안서, 증명 또는 유도, 데이터 분석 보고서, 인터뷰 노트, 스크리닝 기록, 실험 노트 기록입니다. 템플릿마다 고유한 제목, 속성, 태그가 미리 채워집니다.
- 내 템플릿에는 노트 메뉴에서 템플릿으로 사용을 선택한 모든 노트가 나열됩니다. 그중 하나로 노트를 시작하면 제목과 본문의
{{title}},{{date}},{{time}},{{weekday}}가 채워집니다. - 참고문헌에서에는 입력한 내용과 일치하는 항목이 나열됩니다. 제목의 일부, 저자, 인용 키가 해당합니다. 열려 있는 프로젝트의 참고문헌과, Zotero를 연결했다면 Zotero 라이브러리에서 가져옵니다. 항목을 고르면 그 참고문헌의 정보가 채워진 논문 읽기 노트 노트가 시작됩니다. 그 인용 키의 노트가 이미 있으면 Oleafly가 그 노트를 엽니다.

Markdown 파일 가져오기
섹션 제목: “Markdown 파일 가져오기”이미 가진 노트를 가져오려면 사이드바 막대에서 더 보기 → Markdown 가져오기를 선택한 다음 폴더 선택 또는 파일 선택을 고르세요.
.md파일 하나가 노트 하나가 됩니다.- 파일 사이의 링크는 노트 사이의 링크가 되고, 링크된 파일은 첨부 파일로 복사됩니다. 어떤 파일과도 일치하지 않는 링크는 일반 텍스트로 남습니다.
- 5 MB보다 큰 파일은 건너뜁니다.
- 폴더 이름을 태그로 추가는 각 노트에 해당 폴더를 태그로 붙입니다.
Lab/2024에 있는 파일에는Lab/2024태그가 붙습니다.
폴더에 노트가 1,000개를 넘거나 같은 폴더를 전에 가져온 적이 있으면 Oleafly가 먼저 확인을 요청합니다. 가져오기 중지는 가져오기를 언제든 끝내며, 중지한 가져오기는 노트를 하나도 추가하지 않습니다.
빠른 캡처
섹션 제목: “빠른 캡처”빠른 캡처는 지금 쓰던 앱을 벗어나지 않고 생각을 적어 두는 작은 창입니다. 다른 창 위에 계속 떠 있습니다.
빠른 캡처 열기
섹션 제목: “빠른 캡처 열기”macOS에서는 ⌘⇧⌥Space, Windows와 Linux에서는 Ctrl+Shift+Alt+Space를 누르거나 명령 팔레트에서 빠른 캡처를 실행하세요. Oleafly가 실행 중이면 창이 백그라운드에 있어도 이 단축키는 어떤 앱에서든 작동합니다.

키를 바꾸려면 설정 → 키보드 단축키의 노트 탭에서 노트: 빠른 캡처를 편집하세요. 목록 아래의 어디서나 빠른 캡처 스위치는 이 단축키를 끕니다. 다른 앱이 이미 그 키를 쓰고 있으면 설정이 알려 주며, 다른 단축키를 고를 수 있습니다.
Wayland를 쓰는 Linux 데스크톱에서는 앱이 자기 창 밖의 키 입력을 감지할 수 없어서 이 스위치를 쓸 수 없습니다. 대신 설정이 명령을 보여 줍니다. 데스크톱의 키보드 설정에서 이 명령을 실행하는 사용자 지정 단축키를 추가하세요. Oleafly가 실행 중이 아니면 명령이 Oleafly를 시작한 뒤 빠른 캡처를 엽니다.
쓰고 저장하기
섹션 제목: “쓰고 저장하기”빈 줄에 /를 입력하면 제목, 목록 등 여러 블록이 나오고, 서식 표시를 선택하면 서식 막대가 나타납니다. 맨 위의 제목은 첫 줄에서 가져옵니다. 창 위로 포인터를 옮기면 버튼이 나타납니다.
| macOS | Windows / Linux | 동작 |
|---|---|---|
| ⌘↵ | Ctrl+Enter | 새 노트로 저장 |
| ⌘⇧↵ | Ctrl+Shift+Enter | 오늘의 노트에 추가 |
| ⌘K | Ctrl+K | 동작 메뉴 열기 |
| Esc | Esc | 창 닫기 |
- 새 노트로 저장은 쓴 내용을 첫 줄을 제목으로 한 노트로 노트에 저장하고 창을 닫습니다. 이 노트는 프로젝트에 연결되지 않으므로 사이드바의 노트 아래에 나타납니다.
- 오늘의 노트에 추가는 쓴 내용을 오늘의 노트 끝에 추가하며, 노트가 아직 없으면 먼저 데일리 노트 템플릿으로 시작합니다. 데일리 노트가 켜져 있는 동안 제공됩니다.
- 동작 메뉴에는 이 두 가지와 함께 Markdown으로 복사와 초안 삭제가 있습니다.
- 더하기 버튼인 새 노트는 쓴 내용을 노트로 저장하고, 창은 다음 노트를 위해 비운 채 열어 둡니다.
- 노트 열기는 기본 창에서 노트를 엽니다.

창을 닫아도 초안은 남아 있으므로 다음에 빠른 캡처를 열면 그대로 있습니다. 저장에 실패하면 창이 알려 주고 텍스트를 그대로 둬서 다시 시도할 수 있습니다.
노트가 저장되는 위치
섹션 제목: “노트가 저장되는 위치”개인 노트는 프로젝트에 저장되지 않은 노트입니다. 개인 노트는 각각 Oleafly의 프로젝트 폴더 안에, 내 프로젝트 옆에 폴더로 저장됩니다.
| 시스템 | 폴더 |
|---|---|
| Windows | C:\Users\<you>\.oleafly\projects |
| macOS | /Users/<you>/.oleafly/projects |
| Linux | /home/<you>/.oleafly/projects |
여기서 <you>는 사용자 이름입니다. 노트 폴더에는 노트 제목이 아니라 swift-teal-otter 같은 무작위 이름이 붙습니다. 프로젝트 폴더를 열려면 설정 → 데이터 저장 → 로컬 저장소에서 경로 옆의 버튼을 사용하세요. 프로젝트 폴더를 참고하세요.
노트 폴더에는 다음이 들어 있습니다.
note.md: 노트 자체입니다.project.json: 노트의 이름과 연결된 프로젝트가 들어 있습니다.assets: 노트에 추가한 이미지와 파일을 담는 폴더입니다. 노트는assets/로 시작하는 경로로 이 파일들을 링크합니다.
프로젝트에 속한 노트는 대신 그 프로젝트의 notes 폴더에 있는 .md 파일입니다. 프로젝트 노트와 공유 노트를 참고하세요.
클라우드 동기화는 라이브러리 프로젝트와 함께 개인 노트도 백업하며, 프로젝트 목록에서 이 노트에 노트 태그가 붙습니다. 두 컴퓨터에서 동기화되기 전에 노트가 바뀐 경우, 사이드바와 노트 홈에서 노트 옆에 “이 노트에 충돌 사본이 있습니다”라고 알려 주는 아이콘이 표시됩니다. 노트 메뉴에서 충돌 사본 비교를 선택해 차이를 확인한 다음 이 컴퓨터의 버전 유지 또는 다른 컴퓨터의 버전 사용을 선택하세요. 다른 버전은 삭제됩니다.
노트 파일의 모습
섹션 제목: “노트 파일의 모습”노트는 맨 위에 YAML 앞부분 메타데이터(front matter)가 있는 일반 Markdown입니다. Oleafly는 다음 필드를 씁니다.
| 필드 | 담는 내용 |
|---|---|
title | 노트의 제목 |
agent | 에이전트가 노트를 썼을 때 그 에이전트의 이름 |
icon | 노트의 아이콘 |
color | mint 같은 노트의 색상 |
kind | note. 이 파일이 노트임을 나타냅니다 |
id | 다른 노트의 링크가 이 노트를 찾는 데 쓰는 ID |
직접 만든 속성은 tags, aliases와 함께 같은 블록에 들어갑니다. 템플릿으로 쓰는 노트에는 template: true도 있습니다. 노트 파일은 다음과 같은 모습일 수 있습니다.
---title: Field notescolor: mintkind: noteid: 0b7f2c9e-5d1a-4e8b-9c3f-2a6d8e1f4b70tags: [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로 저장하려면 노트 내보내기를 참고하세요.
노트 삭제하기
섹션 제목: “노트 삭제하기”노트 메뉴에서 삭제를 선택한 다음 휴지통으로 이동을 선택하세요. 노트는 노트에서 사라지고, 노트 폴더는 설정 → 데이터 저장 → 로컬 저장소의 휴지통으로 갑니다. 거기서 노트 옆의 복원을 선택하면 되돌릴 수 있습니다. 휴지통을 참고하세요.
노트 모양
섹션 제목: “노트 모양”설정 → 모양 → 노트를 열거나 노트 사이드바 맨 아래의 설정을 선택하세요. 이 탭은 노트가 켜져 있는 동안에만 있습니다. 설정 옆에, 설정 창이 좁으면 설정 위에 샘플 노트가 놓여 변경 내용을 바로 보여 줍니다.

| 그룹 | 설정하는 것 |
|---|---|
| 텍스트 | 서체(산세리프, 세리프, 고정폭), 설치된 모든 글꼴을 쓸 수 있는 노트 글꼴, 노트 글자 크기, 노트 줄 높이, 문단 간격 |
| 제목과 노트 제목 | 제목 서체, 제목 글꼴, 제목 크기, 노트 제목 크기 |
| 레이아웃 | 노트 너비, 노트 정보가 놓일 위치(사이드 패널 또는 인라인), 할 일 체크박스(사각형 또는 원형), 단어 수 표시, 노트 맞춤법 검사, 쌍 목록이 있는 입력하면서 바꾸기, 닫은 뒤에도 실행 취소 유지 |
| 코드 | 코드 글꼴과 코드 블록 색상 |
| LaTeX 그림 | 모든 TikZ 및 CircuiTikZ 블록의 시작 부분이 되는 TikZ 프리앰블 |
| 색상 | 노트 강조 색상, 콜아웃 스타일, 날짜와 필드 칩의 모양 |
| 웹 이미지 | 먼저 묻지 않고 이미지를 불러오는 사이트 |
| 데일리, 주간, 월간 노트 | 주 시작 요일, 그리고 노트 종류마다 제목 형식, 템플릿, 태그와 그 종류를 끄는 스위치 |
바꾼 설정에는 해당 행에 초기화 버튼이 나타납니다. 모양 맨 아래의 기본값으로 초기화는 기본값으로 초기화에 설명된 대로 모양의 나머지와 함께 노트 설정도 초기화합니다. 웹 이미지 아래의 사이트는 그대로 둡니다. 사이트를 제거하려면 그 옆의 버튼을 사용하세요.
다음으로 볼 내용
섹션 제목: “다음으로 볼 내용”- 노트에 쓰기: 편집기, 블록, 링크, 첨부 파일.
- 노트 찾기와 정리: 검색, 태그, 할 일, 데일리 노트, 그래프.
- 프로젝트 노트와 공유 노트: 노트를 프로젝트에 연결하기, 프로젝트 노트, 다른 사람과 함께 노트 쓰기, 읽기 전용 사본 게시하기.
- AI와 함께 쓰는 노트: 노트에 대해 어시스턴트나 CLI 에이전트에게 묻고 제안을 검토하기.