Skip to content

Bookmarks

Sangyong Bae edited this page Sep 28, 2026 · 7 revisions

북마크

줄에 표식을 남기고 돌아오는 기능입니다. 편집·외부 수정 뒤에도 줄 본문과 앞뒤 문맥으로 자리를 다시 찾습니다(못 찾으면 "무효"로 남기고, 30일 뒤 정리).

키

동작 Windows/Linux macOS
토글 Ctrl+F2 · Ctrl+K, Ctrl+K ⌘F2 · ⌘K, ⌘K
다음 / 이전 F2 / Shift+F2 · Ctrl+K, Ctrl+N / Ctrl+K, Ctrl+P F2 / ⇧F2 · ⌘K, ⌘N / ⌘K, ⌘P
이 문서의 북마크 전부 지우기 Ctrl+Shift+F2 · Ctrl+K, Ctrl+X ⌘⇧F2 · ⌘K, ⌘X
북마크 줄 전부 멀티커서 선택 Alt+F2 ⌥F2
니모닉 지정 0~9 Ctrl+Shift+숫자 ⌘⇧숫자
니모닉으로 이동 Ctrl+숫자 ⌘숫자
북마크 패널 Ctrl+Shift+B ⌘⇧B

니모닉을 지정할 때 그 줄에 북마크가 없으면 만들어서 지정합니다. 굵은 키는 Visual Studio식 두 단계 코드(Ctrl+K를 누른 뒤 다음 키) — HHKB처럼 Ctrl+F1~F4를 키보드 펌웨어가 가로채는 키보드용 두 번째 바인딩입니다(둘 다 됩니다 · Preferences ▸ Keys에서 바꿀 수 있음).

편집기 왼쪽 배치는 북마크 영역(색 띠 · 니모닉 상자) → 줄 번호 → 본문 → 미니맵 순입니다. 줄 번호를 꺼도(editor.line_numbers off) 북마크 영역은 그대로 남고, 줄 변경 표시(초록/노랑 막대)는 줄 번호 오른쪽에 따로 있어 북마크와 겹치지 않습니다. 거터를 완전히 없애고 싶으면 대신 미니맵 점과 줄 끝 라벨(bookmark.inline_label)로 위치를 확인하세요.

거터에서 마우스로

편집기 왼쪽 북마크 영역(색 띠·니모닉 상자)이나 줄 번호를 우클릭하면 작은 메뉴가 뜹니다 — 맨 위 Bookmarks(왼쪽 북마크 패널 열기)는 늘 있고, 줄 위에서는 Toggle Bookmark(있으면 ✓ · 한 항목으로 추가/제거)와 Mnemonic ▸ 1~9(없으면 만들어서 지정 · 지금 것은 ✓ · 해제는 니모닉이 있을 때만)가 붙습니다. 마지막 줄 아래 빈 영역에서는 Bookmarks 항목만 나옵니다. 본문 우클릭은 종전대로 편집 메뉴입니다.

표시

  • 거터 색 띠(무효 = 흐림) · 니모닉 숫자 상자 · 미니맵 오른쪽 가장자리 점 · 줄 끝 라벨(◆ 라벨 · 흐린 글) — 설정 Bookmarks ▸ Display에서 각각 끌 수 있고, 라벨 길이 상한은 bookmark.inline_label_chars(40).
  • 상태줄 BM 3/12 = 이 문서 / 전체.

패널(활동 막대 ▸ 북마크)

그룹 → 문서 → 항목 트리 · 필터(Aa · ab · (.*) 토글 · 한글은 조합 중 자모("ㄱ"·"기")로도 바로 걸립니다) · 이름 있는 북마크는 이름이 강조색·굵게 보이고 줄 본문은 흐리게 뒤따릅니다(이름 없는 것은 본문만) · 이름 편집(메뉴 ▸ 이름 · bookmark.label)은 니모닉·줄번호 다음 이름 자리에만 입력 상자가 뜹니다 · 한 번 클릭 = 미리보기 탭으로 열어 그 줄로(편집하면 정식 탭) · 더블클릭 · Enter · 메뉴 Open = 정식 탭(프로젝트 탐색기와 같은 규칙 · 이미 미리보기로 열려 있으면 승격) · 우클릭: 열기 · 니모닉 · 그룹 이동 · 제거(5초 안에 토스트 클릭 = 되돌리기) · 문서/그룹 메뉴(전부 선택 · 이름 바꾸기 · 기본 그룹 · 켜기/끄기 · 삭제) · 무효 북마크 전부 지우기 · 타입어헤드(목록 포커스에서 글자 = 그룹/문서/북마크 이름으로 이동 · 한글 · 탐색기와 필터).

저장 위치

작업 모드에 따라 셋으로 나뉩니다(설정과 같은 층 구조):

모드 어떻게 켜나 북마크 자리
파일 모드 그냥 실행(또는 파일만 인자로) 전역 — 사용자 설정 폴더(%APPDATA%\nexa-sql)의 workspaces/default.nsql-workspace
폴더 모드 nexa-sql . · nexa-sql c:\users\user\project 그 폴더의 .nsql/workspaces/default.nsql-workspace(첫 저장 때 .nsql/을 만듦 · 폴더째 옮기면 따라감)
프로젝트 모드 .nsql-project를 열거나 인자로 프로젝트 파일 안(bookmarks) — 프로젝트와 함께 이동·공유

파일 모드에서 "새 프로젝트 저장"을 하면 그때의 북마크는 프로젝트로 옮겨지고 로컬 파일은 비워집니다(프로젝트를 닫으면 로컬은 비어 있음). 이미 있는 프로젝트를 열 때는 로컬 북마크를 건드리지 않습니다.

이름 없는 탭(Script_N)의 북마크: 프로젝트 모드에서는 탭 본문과 함께 프로젝트 파일에 담겨 다시 열면 그 줄에 붙지만, 파일·폴더 모드에서는 그 탭이 임시라 메모리에만 두고 파일에는 쓰지 않습니다(앱을 다시 켜면 사라짐). 이런 북마크는 탭의 id로만 묶여 있어서, 탭 이름을 바꿔도(우클릭 ▸ 이름 바꾸기) 북마크 패널의 문서 행은 늘 지금 탭 이름을 보여 줍니다 — 만들 때의 이름이 남지 않습니다. 탭을 닫아 이름을 알 수 없으면 (closed tab #id)로 보입니다.

저장 시점: 바꾼 뒤 1초(연속으로 바꾸면 최대 5초) 안에 자동으로 씁니다 — 앱이 가만히 있어도 그 시각에 스스로 깨어 저장합니다. 창을 닫거나 File ▸ Exit로 끝낼 때도 디바운스를 기다리지 않고 바로 씁니다.

CLI

nsql bookmark list [--project <file>] [--doc <path>] [--md]
nsql bookmark add <file> <line> [--label <text>] [--project <file>]
nsql bookmark rm <id> [--project <file>]
nsql bookmark prune [--days N] [--project <file>]

--project x.nsql-project를 주면 그 프로젝트 파일 안의 북마크를 읽고 씁니다(다른 내용은 그대로).

Clone this wiki locally