제텔카스텐 노트

Zettel 공간은 원자적이고 촘촘히 이어진 노트를 위한 전용 자리입니다. 일기 성격의 저널과 달리, ID 기반 [[링크]]와 생각을 볼트에 넣는 두 가지 방법을 중심으로 만들어졌습니다 — 캡처에 노트 이름을 태그로 달면 그 노트 안으로 바로 덧붙고, 태그를 달지 않으면 승격할 때까지 inbox에서 스쳐가는 노트로 기다립니다.

설정

설정(Cmd+,) → 일반 → Zettel을 엽니다
Zettel 토글을 켜고 찾아보기로 디렉터리를 고릅니다(절대 경로)
공간 메뉴(상태바), 명령 팔레트(“Open Zettel”), 또는 Cmd+Alt+2로 공간을 엽니다. Baram이 inbox/와 notes/ 폴더를 자동으로 만듭니다.

켜거나 디렉터리를 정하기 전에 Zettel 공간을 고르면, Baram이 빈 공간으로 전환하지 않고 안내를 보여 줍니다.

허브 패널

Zettel 공간에서는 사이드바가 평범한 파일 트리가 아니라 전용 허브입니다.

동작 — 새 제텔, 빠른 캡처, 새 MOC를 한 번에(Cmd+Shift+V / Cmd+Shift+N / Cmd+Shift+C와 같습니다).
Inbox 대기열 — inbox/의 모든 스쳐가는 노트를 최신순으로, 첫 줄을 제목으로 삼고 태그를 최대 두 개까지 보여 줍니다. 행을 클릭하면 열리고, 마우스를 올리면 ↑ 승격(노트의 첫 줄이 채워진 승격 대화상자를 엽니다)과 ✕ 삭제(먼저 확인을 받습니다)가 나옵니다.
MOC — #moc 태그가 붙은 색인 노트들.
최근 — notes/에서 가장 최근에 손댄 노트들.

세 목록은 접을 수 있고, 캡처·승격·생성·삭제가 일어나면 허브가 스스로 새로 읽습니다 — 패널 밖에서 만든 캡처까지 포함합니다. 공간이 아직 설정되지 않았으면 허브가 설정으로 가는 링크와 함께 짧은 “Zettel 설정” 안내를 보여 줍니다.

빠른 캡처

Cmd+Shift+N(또는 /capture 슬래시 명령)으로 빠른 캡처를 엽니다 — 다른 일을 하는 중에 놓치고 싶지 않은 생각을 담는 작은 창입니다.

본문은 문서와 똑같은 WYSIWYG 에디터입니다. 제목, 목록, 코드, 수식, / 슬래시 메뉴가 모두 동작합니다. Cmd+Enter로 저장합니다. 비어 있을 때는 Esc로 창이 닫히지만, 무언가를 입력한 뒤에는 취소만이 창을 닫습니다 — 실수로 누른 키가 쓴 것을 버릴 수 없습니다.
창에 이미지를 놓으면 첨부됩니다. 저장하기 전까지 디스크에 아무것도 쓰지 않으므로, 창을 닫아도 떠도는 파일이 남지 않습니다.
에디터 아래 손잡이를 끌어 크기를 조정합니다 — 고른 높이는 다음에도 기억됩니다.
출처에는 URL을 넣을 수 있습니다. 제목 https://… 형태로 쓰면 링크가 됩니다. (태스크 모드는 이 칸을 숨깁니다 — 태스크는 한 줄이라 출처를 실을 자리가 없습니다.)
태그 칸이 캡처가 갈 곳을 정합니다 — 아래를 보십시오.

빠른 캡처에는 태스크 모드(Cmd+Alt+T)도 있습니다. 노트를 쓰는 대신 캡처 파일에 태스크 줄을 덧붙입니다. 태스크 캡처하기 참조.

캡처가 착지하는 곳

태그는 주소입니다. 캡처에 #Inspiration을 달면 Inspiration이라는 노트의 본문 안으로 덧붙습니다 — 승격할 것도, 나중에 비울 inbox도 없습니다.

맞추는 대상은 노트의 **제목과 YAML 전문의 aliases:**이고 대소문자를 무시합니다. 노트 자신의 태그는 일부러 보지 않습니다 — 자기 태그를 달고 있는 허브 노트가 두 경로로 자기를 맞추지 못하게 하려는 것입니다. 태그에는 공백이 들어갈 수 없으므로, 제목에 공백이 있는 노트는 별칭으로만 닿을 수 있습니다.

---
aliases: [Baram-Dev-Note]
---

무엇을 태그하면	어디로 가는가
한 노트와 맞는 태그 하나	그 노트에 덧붙습니다
여러 노트와 맞는 태그들	그 모두에 덧붙습니다
같은 노트의 제목과 별칭	한 번만 덧붙습니다 — 대상이 중복 제거됩니다
아무것과도 맞지 않는 태그	맞지 않았다고 알려 주고 어디에도 쓰지 않습니다
맞는 태그가 하나도 없음	전처럼 `inbox/{id}.md`에 스쳐가는 노트로 저장됩니다

캡처가 어디로 가는지는 두 가지가 알려 줍니다.

입력하는 동안 태그 칸 아래 줄이 목적지를 미리 보여 줍니다 — 노트 하나면 → Inspiration (12 captures), 여럿이면 → 3 notes: …, 없으면 → No matching note · saved to inbox. 노트 폴더를 실제로 읽기 전까지는 조용히 있으므로, 맞는 태그가 잠깐이라도 “맞는 게 없다”고 오해받는 일이 없습니다.
저장한 뒤에는 토스트가 노트 이름을 대고 열기를 제안합니다. 대상이 둘 이상이면 어느 것을 열려 했는지 알 수 없으므로 개수만 알려 줍니다.

태그 칸은 실제로 노트를 주소로 지목할 수 있는 이름 — 제목과 별칭 — 을, 그 공간에서 이미 쓰인 태그와 함께 자동완성합니다.

⚠️ 아무 노트와도 맞지 않는 태그는 어디에도 저장되지 않습니다. 토스트가 알려 주지만(#typo matches no note), 그 태그 자체는 파일에 남지 않습니다. 이전 버전과 의도적으로 달라진 점입니다 — 전에는 모든 캡처가 inbox 노트가 되고 태그가 YAML 전문에 보관됐습니다. 여기서 태그는 분류가 아니라 주소입니다.

대상 노트가 저장하지 않은 변경이 있는 탭으로 열려 있으면, 그 노트는 건너뛰고 대화상자가 그 이름을 대며 열린 채 남습니다 — 그 탭을 저장하고 다시 시도하십시오. 이미 쓰인 노트는 자기 항목을 그대로 갖고 있으므로 다시 시도해도 중복되지 않습니다.

허브 노트와 Captures 구역

캡처는 그 노트의 ## Captures 구역 맨 위에, 최신순으로 덧붙습니다. 그런 구역이 없으면 파일 끝에 하나 만듭니다.

## Captures

### 2026-09-06 15:30 ^m2609061530

캡처한 생각이, 서식을 온전히 유지한 채로.

Source: [Title](https://example.com)

## Captures는 고정되고 번역되지 않는 제목입니다. 인터페이스 언어를 따르지 않으므로, 언어를 바꿨다고 한 노트에 캡처 구역이 둘 생기는 일이 없습니다.
항목마다 현지 날짜·시간이 담긴 ### 제목 하나가 있고, 그 제목 줄 끝에 블록 ID(^m…)가 붙습니다. 그 ID는 평범한 블록 앵커입니다 — 어디서든 ((NoteName#^m2609061530))으로 그 항목을 가리키거나 {{embed ((NoteName#^m2609061530))}}으로 끌어올 수 있습니다.
노트의 다른 것은 건드리지 않습니다. 직접 쓴 제목과 산문, 그리고 ## Captures 뒤에 오는 어떤 구역도 있던 자리에 그대로 남습니다.

이렇게 캡처를 모으는 노트가 허브 노트입니다 — 한 번에 하나씩 열어야 하는 조각 폴더 대신, 계속 써 넣고 통째로 읽는 문서 하나입니다. 어떤 노트든 허브가 될 수 있습니다: 그 이름을 태그로 캡처하면 구역이 나타납니다.

영구 노트로 승격

inbox 노트를 열고 Cmd+Shift+U를 누르면 승격합니다. 제목을 주면 notes/{id} {title}.md로 옮겨지고 본문과 태그를 그대로 가져갑니다.
영구 노트를 바로 만들려면 Cmd+Shift+V(새 제텔)를 누릅니다.
선택한 텍스트를 새 노트로 만들려면 Cmd+Shift+Y(선택 영역으로 새 노트 만들기)를 누릅니다 — 선택 영역이 새 노트로 가는 [[id]] 링크로 바뀝니다.

노트 잇기

노트는 {id} {title}.md로 저장되고 id는 타임스탬프입니다. 링크는 [[id]]로 저장되지만 에디터에서는 그 노트의 현재 제목으로 렌더되므로, 노트 이름을 바꿔도 링크가 깨지지 않습니다.
[[를 입력해 제목으로 검색합니다. 노트를 고르면 그 [[id]] 링크가 들어갑니다. 링크를 Cmd+클릭하면 대상이 열립니다.

콘텐츠 지도 (MOC)

Cmd+Shift+C(새 MOC)를 누르면 #moc 태그가 붙은 색인 노트가 만들어집니다 — 관련 노트로 이어지는, 손으로 고른 진입점입니다. #moc 태그를 검색해 MOC를 찾습니다.