LightNote 도움말

Windows용 경량 코드/노트 편집기입니다. 사이드바에 섹션 목록이 있으며, 지금 읽고 있는 위치를 따라갑니다. 창 상단의 홈과 뒤로 버튼으로 처음으로 돌아가고, 검색 상자로 이 도움말의 텍스트를 찾을 수 있습니다(Enter로 다음, F3 / Shift+F3으로 이동). 언제든지 F1을 누르면 현재 화면에 해당하는 섹션에서 이 도움말이 열립니다.

목차

편집

• 개요
• 작업 공간과 창
• 코드 편집기
• Markdown과 위키링크
• 연결 그래프
• 표(Parquet, CSV, JSON, Excel)
• PDF와 이미지
• 이미지: 스크린샷에 주석 달기
• 폴더처럼 열리는 Zip(.zip)
• 블록(.lnb)
• 작업(칸반 / 간트)
• 사용자 지정 표(.lnd)
• 베이스(노트 저장 쿼리)

도구

• 파일 검색과 대기 항목
• 버전 관리(쉬운 Git)
• 스냅샷과 백업
• 변경 사항 검토(체크포인트)
• 파일 비교(diff)
• 코드 실행(F5)
• 터미널과 AI CLI
• 선택 영역에 대한 AI 어시스턴트(Ctrl+K / Ctrl+I)
• AI 세션
• AI 채팅
• HTTP API 테스트
• 데이터베이스(.lnc)
• SSH 연결(.lns)
• 보안: 암호 구문, PIN, .lne
• 일일 노트, 빠른 캡처, 트레이
• 오래된 노트 다시 찾기
• 휴대폰에서 노트 사용하기
• 오디오 녹음 및 전사
• 스티커 메모
• 캘린더
• 명령 팔레트

자동화(AI / 스크립트)

• MCP 서버(AI 에이전트)
• 명령줄(lnote)

참고

• 설정과 테마
• 키보드 단축키
• 라이선스, 에디션, 커뮤니티

개요

LightNote는 폴더를 작업 공간으로 열고, 왼쪽에 파일 트리를, 오른쪽에 편집 탭을, 아래쪽에 상태 표시줄을 보여줍니다. 사이드바 상단의 작은 탭 모음에서 탐색기(트리), 검색, 버전 관리(Git), 파일 기록, 대기 항목(TODO/FIXME 및 노트 작업) 섹션을 전환할 수 있습니다.

코드와 노트 외에도 다양한 형식을 알맞은 방식으로 열고 편집합니다: 표(DuckDB를 통한 Parquet/CSV/JSON, Excel .xlsx), PDF, 이미지 (애니메이션 GIF 포함), 폴더처럼 열리는 .zip, 블록 노트(.lnb), 작업 보드(.lnt), 사용자 지정 표(.lnd), 데이터베이스 연결(.lnc), SSH 연결(.lns). 통합 터미널, 전역 검색(ripgrep), 간소화된 Git 버전 관리, AI CLI와의 연동, MCP 서버, 자동화용 명령줄(lnote)도 제공합니다.

처음이신가요? 소개 자료(시작 작업 공간)는 도움말 → 시작 투어 다시 열기에서 언제든지 다시 볼 수 있습니다.

작업 공간과 창

연 루트 폴더가 작업 공간입니다. 그냥 여는 것만으로는 아무것도 생성되지 않으며, 닫을 때 LightNote는 작은 세션 파일(열린 탭과 위치)만 기록합니다. 작업 공간은 도구 → 작업 공간 설정에서 버전 관리(Git) 또는 MCP를 활성화해야만 자체 설정이 저장되는 "프로젝트"가 됩니다.

일반 설정은 애플리케이션 전체에 적용되고, 작업 공간 설정은 연 폴더에만 적용됩니다. 설정과 상태는 폴더 곳곳에 흩어지지 않고 중앙 데이터베이스에 저장됩니다.

LightNote는 단일 인스턴스로 실행됩니다. 두 번째 폴더를 열면 기존 프로세스를 재사용합니다(다중 창, 메모리 절약). 트레이 아이콘과 작업 공간을 검색 상자로 나열하는 런처가 있으며(즐겨찾기는 컨텍스트 메뉴로 맨 위에 고정) 자세한 내용은 일일 노트와 트레이를 참고하세요. 각 탭은 탭 바의 컨텍스트 메뉴로 색상 라벨을 지정할 수 있습니다. 반복되는 노트를 위해서는 Modelos(또는 Templates) 폴더를 만들고 .md 파일을 넣은 뒤 파일 → 템플릿에서 새 노트…를 사용하세요.

형식을 골라 파일 만들기. 새로 만들기 메뉴(☰ 파일, 활동 표시줄의 새로 만들기 버튼, 폴더 컨텍스트 메뉴의 새로 만들기)에는 새 노트 (.md), 새 텍스트 파일 (.txt), 그리고 자주 쓰는 언어를 모은 새 코드 파일 하위 메뉴가 있습니다. 모두 기본 이름으로 즉시 디스크에 파일을 만들고 트리에서 이름 편집을 엽니다. 이름 부분만 미리 선택되므로 제목을 입력해도 확장자가 지워지지 않습니다. 제안된 이름을 그대로 쓰려면 편집기를 클릭하고 쓰기 시작하면 됩니다. 하위 메뉴에 없는 확장자는 파일을 만든 뒤 이름을 바꾸세요(F2). 확장자를 바꾸면 보기도 바뀝니다. .txt를 .md로 바꾸면 같은 탭이 노트로 다시 열리며 미리 보기와 개요가 함께 나옵니다. 반대로 하면 코드 편집기로 돌아갑니다. LightNote 고유 확장자(.lnc, .lne, .lnq, .lnh, .lns 및 번들)는 예외입니다. 그곳에서는 확장자가 내용의 형식을 선언하므로, 이름 바꾸기는 확인을 요구하고 탭이 열려 있는 동안에는 거부됩니다.

새 파일이 만들어지는 위치. 새로 만들기는 항상 탐색기에서 표시된 폴더에 만들며, 표시된 폴더는 언제나 정확히 하나입니다. 트리 맨 위에는 루트 폴더 행이 있고 작업 공간 이름을 표시합니다. 다른 항목과 똑같은 항목이며, 클릭하면 대상이 루트로 돌아갑니다. 폴더를 선택하면 표시가 그 폴더로 옮겨지고, 파일을 선택하면 그 파일이 들어 있는 폴더가 표시됩니다. 폴더를 보여 주지 않는 목록 모드에서는 표시가 루트 행에 남고 그 행이 실제 대상을 보여 줍니다. 루트 행의 컨텍스트 메뉴에는 새로 만들기와 폴더 만들기가 있습니다.

파일을 작업 공간으로 바꾸지 않고 낱개로 열려면 낱개 파일 열기… (트레이 메뉴)를 사용하세요. 독립 창에 파일 트리가 표시되지만 Git, MCP, 테마 재정의는 없습니다. 설정 → 일반 → 기능에서 활성화하면 LightNote가 Windows 탐색기 메뉴에 통합됩니다(사용자별, 관리자 권한 불필요). "연결 프로그램" 목록 외에도 컨텍스트 메뉴에 모든 파일에서 "LightNote로 열기", 폴더에서 "LightNote 작업 공간으로 열기"가 추가됩니다(Windows 11에서는 추가 옵션 표시 안). 파일은 해당 독립 창에서, 폴더는 작업 공간으로 열립니다.

Windows 탐색기에서 여러 파일을 한 번에 선택하면 — 서로 다른 폴더에 있는 파일이라도 — 모두 같은 독립 창에 탭으로 나란히 열립니다(파일마다 창이 따로 열리지 않습니다). 이 창의 탭은 기억됩니다. 창을 닫았다가 다시 열면 같은 파일들이 돌아옵니다. 여기서는 탭이 중심이므로 파일 트리는 접힌 상태로 시작합니다. Ctrl+B(또는 활동 표시줄 상단의 버튼)로 표시할 수 있습니다.

세션으로 돌아가기. 개별 파일 창은 어디에서나 개별 파일이라는 이름으로 나타납니다. 다른 창이 작업 공간 이름을 보여 주는 제목 표시줄에도 이 이름이 나오므로 Alt+Tab에서 구분할 수 있습니다. 트레이 메뉴의 열기에서는 저장된 탭이 있을 때 (탭 N개)가 뒤에 붙으며, 클릭하면 모두 돌아옵니다. 런처의 첫 줄에도 작업 공간과 나란히 표시됩니다. 또한 LightNote를 다시 열면 종료할 때 열려 있던 모두가 돌아옵니다. 각 창은 자기 폴더로, 개별 창도 함께 돌아옵니다. 마지막으로 사용한 폴더만 열고 싶다면 설정 → 일반 → 인터페이스 → 시작할 때 열기에서 바꾸세요. 종료 전에 닫은 창은 제외됩니다. 닫는 것이 "이 공간은 다 썼다"는 뜻이기 때문입니다.

즐겨찾기: 사이드바에는 즐겨찾기 섹션이 있어 고정한 항목(트리나 탭의 컨텍스트 메뉴 → 즐겨찾기에 추가)과 최근에 연 파일이 표시됩니다. 고정 항목은 폴더별이며 상대 경로로 저장되므로 작업 공간을 옮겨도 유지됩니다.

탭을 별도 창에서 열기: 탭의 컨텍스트 메뉴에서 새 창에서 열기를 선택하면 해당 파일이 독립 창에서 다시 열립니다(코드 옆에 노트를 두기에 편리). 작업 공간에 의존하는 형식(.lnc, .lne, .lns 및 번들)은 분리할 수 없습니다.

다중 선택. 트리는 세 가지 보기 모드 모두에서 Ctrl+클릭(개별)과 Shift+클릭(범위)을 받습니다. 여러 항목을 선택하면 컨텍스트 메뉴가 선택 전체에 작용합니다: 잘라내기와 복사(Windows 탐색기와 상호 운용), 삭제(전체에 대해 확인 한 번), 복제, 해시 복사, .zip으로 압축(하나의 압축 파일, 각 항목이 자기 이름으로 최상위에 들어감), 색 적용, 즐겨찾기, Git(add/restore), 경로 복사(항목당 한 줄). 한 항목에만 의미가 있는 동작—인라인 이름 바꾸기, 속성, 다른 형식으로 열기, 변환—은 비활성이 되고 이유가 툴팁에 표시됩니다. 선택 안쪽을 오른쪽 클릭하면 선택이 유지되고, 바깥을 클릭하면 클릭한 항목만 선택됩니다. 폴더와 그 안의 항목을 함께 선택해도 작업이 두 번 실행되지 않습니다: 안쪽 항목은 제외됩니다.

열지 않고 엿보기. 파일을 한 번 클릭하면 이미 미리 보기 탭이 열립니다(재사용되며 탭 바에서 기울임꼴로 표시). 화살표 키로 트리를 이동하는 중에는 Space 키가 같은 일을 하고 포커스를 트리로 돌려주어 목록을 계속 내려갈 수 있습니다.

파일 도구. 탐색기 컨텍스트 메뉴에 파일 도구 하위 메뉴가 있습니다: 일괄 이름 바꾸기(확장자/와일드카드/정규식 필터 + 미리보기와 충돌 감지가 있는 규칙 파이프라인), 파일 나누기(줄·크기·정규식 구분자), 파일 합치기(선택적으로 첫 번째 CSV 헤더만 유지), 복제, 해시 복사(MD5/SHA-256), .zip으로 압축 / 여기에 압축 풀기. 여러 항목을 선택한 경우 일괄 이름 바꾸기와 파일 합치기는 고른 항목을 그대로 받습니다(폴더를 훑지 않음). 합치기는 선택한 순서를 지킵니다.

단독 창의 이동. 트리 위에 뒤로(Alt+←), 앞으로(Alt+→), 위로 버튼과 클릭할 수 있는 폴더 경로가 있습니다 — 각 구간을 누르면 그 단계로 갑니다. 마우스 측면 버튼으로도 뒤로/앞으로 갈 수 있습니다. 경로를 입력하려면 띠의 빈 곳을 클릭하거나 Ctrl+L을 누르세요. Esc는 취소하고 경로로 돌아갑니다. 탭을 전환하면 표시된 폴더도 이동합니다: 독립 창은 서로 다른 폴더의 탭을 모으므로, 탭을 클릭하면 해당 폴더로 이동합니다.

메뉴. 활동 표시줄 위쪽의 ☰ 버튼에 파일, 편집, 보기, 창, 도구, AI, 도움말 메뉴가 모여 있습니다. AI 동작은 전용 메뉴에 있습니다(활동 표시줄의 지팡이 버튼으로도 열립니다). 도구에서는 하위 메뉴로 묶여 있습니다: 실행(F5/F6/F8, lint, 터미널로 보내기, 매크로), 캡처(오늘의 노트, 빠른 캡처, 빠른 작업, 오디오 녹음, 스티커 메모), 작업 공간(설정, 스냅샷, 복사본 내보내기, 폴더 이동) — 마지막 항목은 톱니바퀴 메뉴에도 있습니다. 새로 만들기 메뉴는 나타나는 세 곳(☰ 파일, 새로 만들기 버튼, 폴더 컨텍스트 메뉴의 새로 만들기)에서 동일합니다.

코드 편집기

텍스트/코드 파일은 구문 강조가 적용된 편집기(Scintilla)에서 열립니다. 주석/주석 해제(Ctrl+/), 줄 이동 및 복제, 북마크(Ctrl+F2), 심볼/함수 목록, 단어 기반 자동완성, 들여쓰기 안내선, 자동 줄바꿈, 확대/축소, 디스크상 파일 변경 감지 기능이 있습니다. 버전 관리를 활성화하면 여백에 마지막 버전 이후 추가/변경된 줄이 표시됩니다.

매크로(Ctrl+Shift+R / F4로 편집 시퀀스 기록/재생, 도구 → 매크로), 서식/정리(Shift+Alt+F), 탭 도구 모음의 ASCII 표(문자/박스 그리기 문자 삽입용), 맞춤법 검사기 (Hunspell)도 있습니다. pt-BR와 en-US는 내장되어 있으며, 다른 언어는 설정 → 노트 및 글쓰기 → 맞춤법의 표(언어별 한 행, 다운로드/ 제거 버튼 포함)에서 필요할 때 다운로드합니다. 기록 중인 로그 파일을 따라가려면 탭 자체 도구 모음의 모니터링 (tail -f) 버튼을 사용하세요. 매우 큰 파일(약 1 MB 이상)은 보이는 부분만 불러오는 가상화된 경량 편집기에서 열리며, 파일 → 경량 편집기에서 열기…로 강제로 사용할 수도 있습니다.

서식과 린트: Shift+Alt+F는 언어의 외부 포매터 (black, prettier, clang-format, gofmt, rustfmt 등)가 설치되어 있으면 그것으로 문서 서식을 맞추고, 없으면 오프라인 내부 포매터(JSON/XML)로 대체합니다. F7은 언어의 린터(ruff, eslint, shellcheck, luacheck 등)를 실행해 편집기와 문제 패널(하단 창, 이동 가능)에 밑줄로 문제를 표시합니다. 두 기능 모두 설정 → 서식과 → 린터에 카탈로그와 추가 버튼이 있고, 저장 시 서식 맞추기 / 저장 시 린트 옵션도 있습니다. F6으로 파일을 출력 패널에서 실행하거나(종료 코드와 소요 시간 기록, 중지/재시작 가능) F8로 일부 코드만 실행할 수 있습니다.

추가 편집 기능: 항목별 다중 커서(Ctrl+D, 전체는 Alt+F3), 줄 복제(Ctrl+Shift+D), 줄 합치기 (Ctrl+Shift+J), 범위 단위 선택 확장/축소(Ctrl+Shift+Space / Ctrl+Alt+Space), 사각형 선택(Alt+드래그), 모두 접기/펼치기, 스니펫(Ctrl+J, 설정 → 편집기에서 편집 가능), 파일 내 심볼로 이동(팔레트의 #)과 프로젝트 내 이동 (Ctrl+T 또는 ##), 이동 기록(Alt+←/→), 편집기 상단의 브레드크럼 경로, 열 눈금자, 괄호 쌍 색상 강조, 자동 닫기/감싸기 괄호, 저장 시 정리(공백 제거, 끝 줄바꿈)까지 모두 설정 → 편집기에 있습니다.

로컬 기록과 클립보드: 저장할 때마다 LightNote는 파일의 버전을 보관합니다(파일 → 로컬 기록…, 복원 가능, Git과는 별개). Ctrl+Alt+V는 클립보드 기록을 열어 이전에 복사한 항목을 붙여넣습니다. Ctrl+Shift+T는 마지막에 닫은 탭을 다시 엽니다. 탭은 고정할 수 있으며(컨텍스트 메뉴), 고정된 탭은 유휴 상태에서 해제되지 않도록 보호됩니다.

정의로 이동: 식별자 위에서 F12 또는 Ctrl+클릭하면 프로젝트에서 정의된 위치로 이동합니다. Shift+F12는 사용처를 찾습니다.

미니맵. 편집기 오른쪽 가장자리에 문서 전체의 축소판이 표시됩니다. 코드의 ‘형태’(구문 강조 색을 축소한 모습)를 보여 주고 현재 보이는 영역을 표시합니다. 클릭하거나 드래그하면 파일의 어느 위치로든 이동합니다. 보기 → 미니맵 또는 설정 → 편집기에서 켜고 끕니다. 코드 탭 자체 도구 모음의 미니맵 버튼(ASCII 옆)으로 편집기를 벗어나지 않고 켜고 끌 수 있습니다. 축소판 왼쪽 가장자리에는 표시 띠가 있습니다. 파란색은 책갈피가 있는 줄(여백의 점과 같은 것), 호박색은 빠른 검색의 일치 항목입니다. 화면 밖 부분까지 포함해 파일 전체에 어떻게 분포하는지 한눈에 볼 수 있습니다.

텍스트 조작. 편집 메뉴(및 편집기 컨텍스트 메뉴)에 줄(이동, 복제, 삭제, 정렬, 합치기, 뒤집기, 번호 매기기)과 정리(공백 제거, 빈 줄·중복 줄 제거, 탭 ↔ 공백) 하위 메뉴가 있습니다. 선택 영역이 있으면 컨텍스트 메뉴에 선택 영역을 새 파일로 저장…도 나타나며, 현재 파일 옆에 조각을 기록하고 탭으로 엽니다(원본은 그대로).

Markdown과 위키링크

.md 노트는 편집기와 미리보기가 나란히 열립니다(설정 가능). 커서가 있는 문단 밖의 마크업은 흐리게 표시되어 완성된 문서처럼 보입니다.

단축키: Ctrl+B/Ctrl+I는 굵게/기울임을 적용하고 Ctrl+E는 보기 모드(편집 → 분할 → 읽기)를 전환합니다.

위키링크: [[를 입력하면 작업 공간 노트로 자동완성되고, 링크는 ]]로 스스로 닫힙니다. Ctrl을 누른 채 [[노트]]를 클릭하면 해당 노트가 열립니다. 링크 패널은 노트 간의 연결을 보여줍니다.

풍부한 미리보기: 코드 블록은 언어 라벨과 복사 링크가 있는 상자로 표시되고, ~~취소선~~과 ==하이라이트==가 렌더링되며, GitHub 스타일 콜아웃(> [!NOTE], [!TIP], [!WARNING], [!IMPORTANT], [!CAUTION])은 색상이 있는 상자로 바뀝니다. #해시태그 태그는 강조 표시되고 Ctrl+클릭하면 해당 태그로 검색이 열립니다. 상단의 YAML 프론트매터 블록(---)도 강조됩니다. 탭 도구 모음에는 노트를 PDF/HTML로 내보내는 버튼, 가운데 정렬을 켤 수 있는 읽기 칼럼, 편집기/양쪽/미리보기 모드 전환 버튼이 있습니다. Zen 모드(F11)와 타자기 스크롤은 방해 없이 글을 쓰도록 도와줍니다.

미리 보기의 새 기능: ~~취소선~~ 과 ==강조== 외에도 위 첨자 ^x^, 아래 첨자 ~x~, 단축 이모지（:rocket:）, URL 자동 링크, 각주 [^1], 접이식 블록 <details>, 정의 목록, 작업 - [ ]/- [x]（⬜/✅）, 그리고 [TOC] 마커（미리 보기 안의 클릭 가능한 목차）를 사용할 수 있습니다. 로컬 이미지와 인라인 HTML（<kbd>, <mark>…）도 지원합니다. 개요 패널（탭 도구 모음）은 제목을 따라가며 커서를 따라가고, 삽입 버튼（또는 컨텍스트 메뉴 → 서식/삽입）으로 어떤 서식이든 적용할 수 있습니다.

고정 머리글(sticky scroll): 스크롤하면 맨 위 줄을 포함하는 머리글이 편집기 상단의 띠에 고정되며, 클릭하면 해당 섹션으로 이동합니다(설정 → Markdown에서 켜기/끄기). 트리에서 폴더의 컨텍스트 메뉴로 폴더 노트(프런트매터가 있는 index.md)를 만들거나 열 수 있어 색인으로 유용합니다.

폴더 노트와 파일 목록: 폴더를 더블 클릭하면 해당 index.md가 있으면 열립니다. 어떤 노트에서든 한 줄에 단독으로 있는 [files](또는 [arquivos]) 토큰은 미리보기에서 그 노트가 있는 폴더의 파일 목록(클릭 가능한 링크)으로 바뀝니다. [TOC]처럼 즉석에서 생성되며 파일에는 아무것도 쓰지 않습니다.

텍스트 및 줄 조작. 코드 편집기의 조작은 노트에서도 쓸 수 있습니다 — 탭 표시줄의 텍스트 버튼, 컨텍스트 메뉴, 편집 메뉴의 줄·정리 하위 메뉴를 통해: 줄(또는 선택한 여러 줄)을 위/아래로 이동(Ctrl+Shift+↑/↓), 복제(Ctrl+Shift+D), 삭제(Ctrl+Shift+L), 정렬(A→Z / Z→A), 순서 뒤집기, 줄 합치기, 중복 줄·빈 줄 제거, 공백 제거, 대소문자(대문자/소문자/반전). 줄 번호 매기기…는 시작값, 증가폭, 앞자리 0, 구분자를 지정하는 대화 상자를 엽니다. 기본값(". ")이면 올바른 마크다운 번호 목록이 됩니다. 선택 영역이 있으면 그 부분에만(줄 단위로 확장) 적용되고, 없으면 문서 전체에 적용되며 — 항상 실행 취소 한 번으로 되돌릴 수 있습니다. 탭 표시줄에는 AI 버튼(AI에 질문 / AI로 편집)도 있으며, 코드와 같은 Ctrl+K / Ctrl+I 입니다.

접을 수 있는 제목: 제목 왼쪽의 작은 화살표를 클릭하거나(또는 Ctrl+Shift+[ / Ctrl+Shift+]) 사용해 섹션을 접고 펼칠 수 있습니다. 보기 메뉴에는 모든 제목 접기/펼치기가 있습니다. 접기는 순전히 시각적이며 — 파일에 절대 기록되지 않습니다 — LightNote가 세션 간에 기억합니다. 개요나 검색에서 접힌 섹션 안으로 이동하면 자동으로 펼쳐집니다.

노트 속성: 속성 사이드 패널은 YAML frontmatter를 형식이 있는 필드(텍스트, 숫자, 날짜, 체크박스)로 보여주며 위쪽에 유형 상자가 있습니다. 유형과 속성을 지정해야 노트를 베이스로 모을 수 있습니다.

연결 그래프

도구 › 연결 그래프(Ctrl+Alt+G)는 작업 공간의 모든 노트를 인터랙티브 그래프로 보여줍니다: 각 노드는 .md 노트이고 각 선은 위키링크입니다. 노드는 스스로 자리를 잡으며(애니메이션 물리 효과) 드래그할 수 있습니다. 마우스를 올리면 이웃 노드가 강조되고 나머지는 흐려지며, 클릭하면 노트가 열립니다. 스크롤로 확대/축소하고 (가까워지면 이름이 나타남) 배경을 드래그하면 화면을 이동합니다.

탭 도구 모음에는 이름으로 필터(일치하지 않는 노트를 흐리게 표시), 고아 노트(전혀 링크가 없는 노트 — 회색으로 표시) 토글, 힘 슬라이더(척력, 거리, 중력), 그래프를 창에 맞추기, 노트 다시 스캔 기능이 있습니다. 연결이 많을수록 노드가 커지며, 최상위 폴더마다 고유한 색상이 부여됩니다.

표(Parquet, CSV, JSON, Excel)

.parquet 파일은 표로 열리고, .csv, .tsv, .json은 텍스트로 열리며, 트리의 컨텍스트 메뉴에서 표로 열기를 선택할 수 있습니다. 읽기는 DuckDB를 통해 필요 시 페이지 단위로 이루어지며, 정렬 (헤더 클릭)과 필터링은 엔진 쪽에서 처리됩니다. 구조 버튼은 열, 형식, 행 수, Parquet의 경우 행 그룹과 압축 방식을 보여줍니다. 보기 전용입니다.

표 상단의 자유 SQL 바는 모든 DuckDB 쿼리를 받아들이며, t 뷰가 열린 파일을 가리킵니다. 트리의 폴더 컨텍스트 메뉴에서 폴더를 표로 열기를 선택하면 같은 형식의 모든 파일을 하나의 표로 읽어들이고, 표 메뉴에서는 현재 보기를 내보낼 수 있으며 (CSV/Parquet/JSON), 트리 메뉴에서는 표 파일을 다른 형식으로 변환할 수 있습니다. 자유 형식 SQL은 명령줄의 query 명령과 MCP에서도 사용할 수 있습니다.

Excel 스프레드시트(.xlsx)는 시트 선택기가 있는 읽기 전용 표로 열립니다 — Excel 설치 없이 동작하는 경량 리더입니다.

다른 형식으로 복사. LightNote의 모든 표(Parquet/CSV/JSON, Excel, SQL 결과, 작업, 베이스) 컨텍스트 메뉴에서 다른 형식으로 복사는 선택 영역을 이미 서식이 적용된 상태로 클립보드에 넣습니다. 서식 있는 표 (Teams, Outlook…)는 서식 있는 텍스트를 이해하는 프로그램(Teams, Outlook, Word, Excel)에 테두리와 머리글이 있는 진짜 표로 붙여집니다(서식 있는 텍스트가 없으면 자동으로 TSV로 대체됩니다). 나머지는 텍스트로 붙여집니다: 마크다운 표(노트에 바로), CSV(RFC 4180에 따른 따옴표), TSV(탭 구분), HTML(<table> 마크업), JSON, JSONL(레코드당 한 줄), YAML, 그리고 코드 하위 메뉴 — 소스 파일에 붙여넣을 수 있는 리터럴을 생성합니다: Python(딕셔너리 목록) 또는 JavaScript / TypeScript(객체 배열). JSON, YAML, 코드에서는 숫자인 셀이 따옴표 없이 출력되지만 원본 텍스트가 보존되므로 007 같은 ID는 그대로 텍스트로 남습니다. Ctrl+C는 이전과 같이 TSV로 복사합니다.

모든 표가 동일하게 동작합니다. Ctrl+F는 빠른 필터("아무 열에나 포함")에 포커스를 주고, 카운터가 남은 행 수를 보여 주며, CSV로 내보내기가 있습니다 — .xlsx 시트, 작업, 베이스에서도 마찬가지입니다. 그리드 컨텍스트 메뉴에는 여전히 다른 형식으로 복사가 있습니다.

결과 차트. 테이블 사이드바에 차트 버튼(막대, 선 또는 산점도)이 있습니다. 집계는 DuckDB에서 실행되며(원본 행을 가져오지 않음), 오늘의 노트에 추가 버튼으로 차트를 이미지로 저장합니다. 구조 패널에는 열별 프로파일(숫자 열의 미니 히스토그램과 나머지 열의 최빈값)도 포함됩니다.

PDF와 이미지

.pdf 파일은 네이티브 뷰어(Qt6::Pdf, 무거운 의존성 없음)에서 열립니다. CPU로 렌더링하며 WebEngine을 쓰지 않습니다. 이미지는 이미지 보기에서 열리고, 움직이는 GIF는 애니메이션 보기에서 재생됩니다.

탭 도구 모음에는 한 번에 하나씩 표시되는 다섯 개의 측면 패널이 있습니다. 목차(파일 자체에 저장된 목차 — PDF에 목차가 없으면 버튼이 비활성화되고 그 이유를 알려 줍니다), 축소판(스크롤에 따라 렌더링되는 페이지 한눈에 보기), 검색, 링크, 속성(제목, 작성자, 날짜, 페이지와 파일 크기)입니다.

검색(Ctrl+F)은 문서 전체를 훑습니다. 일치하는 부분은 페이지에서 강조되고 앞뒤 문장과 함께 목록에 나열되며, F3 / Shift+F3으로 이동합니다. 훑는 작업은 점진적이라 문서를 지나가는 동안 목록이 늘어납니다.

페이지 입력란은 번호와 인쇄된 페이지 번호를 모두 받습니다. 머리말이 로마 숫자로 매겨진 문서에서 1을 입력하면 첫 장이 아니라 인쇄된 "1" 페이지로 이동합니다. 페이지 모드 단추로 연속 스크롤과 한 번에 한 페이지를 전환합니다.

암호로 보호된 PDF는 열 때 암호를 묻습니다(최대 세 번). 취소하면 탭이 열리지 않을 뿐입니다. 같은 실행 중에는 다시 묻지 않습니다. 앱이 오래 쓰지 않은 탭을 해제한 뒤 스스로 다시 열기 때문에, 그대로 두면 앱이 스스로 번거로움을 만드는 셈이기 때문입니다. 암호 입력창에서 "이 파일의 암호 기억하기"를 선택하면 다음 실행에서도 유지됩니다. 암호는 Windows가 보호하며(이 컴퓨터의 사용자 본인만), Git이나 클라우드로 전송되지 않고 설정 내보내기에도 포함되지 않습니다. 모두 지우려면 설정 → 기능 → PDF 암호. 보호된 PDF는 프로그램을 시작할 때 자동으로 다시 열리지 않습니다. 창을 보여 주기도 전에 암호 요청을 줄 세우는 대신, 사용자가 열기를 기다립니다.

도구 모음의 작업 메뉴에서 페이지 텍스트 복사, 문서 전체 텍스트 내보내기, 페이지를 이미지로 복사하거나 저장하기, 그리고 페이지를 오늘의 노트로 보내기를 할 수 있습니다. 링크 패널이 있는 이유는 Qt의 PDF 구성 요소가 내부 링크는 스스로 따라가지만 외부 링크는 무시하기 때문입니다. 웹 주소는 확인을 거쳐 이 패널에서 열립니다.

제한: 마우스로 텍스트를 선택할 수 없습니다. Qt의 PDF 구성 요소가 그 기능을 제공하지 않기 때문입니다. 내용을 가져가려면 "이 페이지의 텍스트 복사"나 문서 내보내기를 사용하세요.

이미지: 스크린샷에 주석 달기

이미지는 자체 도구 모음이 있는 탭에서 열립니다. 회전, 반전, 확대 외에 주석 도구를 함께 제공합니다. 스크린샷을 찍고, 중요한 부분을 가리키고, 그대로 문서로 가져가는 길입니다.

기본 도구는 이동입니다. 드래그는 예전처럼 이미지를 움직입니다. 선택은 일부를 고릅니다 — 드래그로 만들고, 안쪽을 드래그해 옮기고, 모서리와 변의 핸들로 크기를 바꿉니다. Esc는 선택을 해제하고 Del은 그 영역의 내용을 지웁니다. 이동 모드에서는 Shift+드래그로도 선택할 수 있습니다. 어떤 도구에서든 마우스 가운데 버튼으로 이미지를 움직일 수 있습니다.

스포이트는 이미지 자체에서 색을 가져옵니다. 왼쪽 버튼은 테두리 색으로, 오른쪽 버튼은 채우기 색으로 들어갑니다. 주석이 그려진 뒤의 이미지를 읽으므로, 방금 만든 주석과 같은 색을 다시 쓰는 데도 좋습니다.

나머지는 그리는 도구입니다. 사각형, 타원, 화살표, 선, 강조(형광펜처럼 반투명), 펜(자유 곡선), 브러시, 번호 단계(1, 2, 3... 자동으로 번호가 매겨집니다), 텍스트, 흐리기, 스포트라이트(선택한 영역을 제외한 나머지를 어둡게 합니다). 그리는 동안 Shift를 누르면 정사각형·정원과 45° 각도로 고정됩니다.

색은 두 가지이고 버튼도 두 개입니다. 테두리 색(선과 라벨의 색이기도 합니다)과 채우기 색이며, 채우기는 없음으로 둘 수 있습니다. 채우기가 없으면 사각형과 타원은 윤곽만 그려지고, 번호 단계와 텍스트는 테두리 색을 배경으로 삼아 라벨을 흰색이나 검정 — 대비가 나는 쪽 — 으로 씁니다. 채우기를 고르면 그것이 도형의 안쪽과 라벨의 배경이 되고, 테두리 색이 글자 색이 됩니다.

브러시는 채우기 색으로 선 두께만 한 점을 찍습니다. 둥근 모양인지 네모난 모양인지는 두께 옆 버튼으로 바꿉니다. 한 번만 클릭해도 자국이 남습니다. 채우기를 흰색으로 두면 지우개가 되어 아래에 있는 것을 덮습니다.

두께는 선, 라벨의 크기, 그리고 흐리기의 블록 크기에 적용됩니다. 두께를 쓰지 않는 도구에서는 흐리게 표시됩니다. 색과 두께는 세션이 바뀌어도 기억됩니다. Ctrl+Z와 Ctrl+Y로 주석을 취소하거나 다시 실행하고, 주석 지우기는 한 번에 모두 지웁니다(이것도 되돌릴 수 있습니다).

흐리기는 감추기 위한 것입니다(토큰, 이메일 주소, 경로 등). 탭이 열려 있는 동안에는 되돌릴 수 있지만, 저장하거나 복사하면 그 영역의 픽셀은 실제로 파괴됩니다. 밖으로 나가는 파일은 원본을 어디에도 남기지 않습니다.

이름이 비슷하지만 하는 일이 다른 세 가지 작업이 있습니다. 잘라내기(Ctrl+X)는 선택 영역을 클립보드로 복사하고 그 영역을 지웁니다. 지운 자리는 채우기 색(없으면 흰색)으로 칠해집니다. 선택은 그대로 남아 있어서, 바로 이어서 붙여넣기를 하면 잘라낸 조각이 원래 있던 자리에 떠 있는 상태로 되돌아옵니다 — 이미지의 한 부분을 옮기는 방법입니다. Del은 복사하지 않는 잘라내기입니다. 반면 이미지 메뉴의 선택 영역만 남기기는 반대입니다. 그 영역만 남기고 나머지를 버리며 이미지의 크기를 바꿉니다.

나머지 식구들입니다. 복사는 주석이 있는 이미지 또는 선택 영역만 가져갑니다. 붙여넣기는 클립보드의 이미지를 떠 있는 상태로 가져옵니다 — 같은 핸들로 옮기고 크기를 바꾼 뒤 바깥을 클릭하거나 Enter를 누르면 확정되고, Esc는 버립니다. Ctrl+A(또는 Ctrl+T)는 이미지 전체를 선택합니다. 그 밖에 저장(주석을 파일 자체에 기록합니다), 다른 이름으로 저장..., 그리고 오늘의 노트로 보내기가 있으며 이는 PNG를 Anexos/에 저장하고 노트에 ![]()를 넣습니다. 저장하지 않은 주석이 있는 동안 탭에는 별표가 남고, 닫을 때 저장할지 묻습니다.

이미지 버튼에는 그림 전체에 적용되는 것들이 모여 있습니다. 회전, 반전, 백분율로 크기 변경, 너비 1600 / 1200 / 800 px로 축소(스크린샷은 문서에 넣기에는 너무 큰 크기로 만들어집니다), 단색 테두리 잘라내기, 여백 추가, 그림자, 그리고 주석을 이미지에 새기기입니다. 마지막 항목은 주석을 그 자리에서 픽셀로 바꾸며, 그래야 주석 위에 흐리기를 할 수 있습니다. 크기 변경은 주석과 선 두께도 함께 가져갑니다.

LightNote를 벗어나지 않고 화면을 찍으려면 트레이 메뉴의 화면 캡처...(또는 Ctrl+Alt+P)를 사용하세요. 바탕 화면이 멈추고, 드래그로 영역을 고르면(Esc로 취소) 잘라낸 부분이 새 탭에서 열려 바로 주석을 달 수 있습니다.

제한: 이미 그린 주석은 옮기거나 고칠 수 없습니다 — Ctrl+Z로 취소하고 다시 그리세요. 움직이는 GIF와 WebP는 애니메이션 보기에서 열리며 주석 기능이 없습니다. 그리고 .svg는 읽을 때 래스터화되므로 저장할 때 PNG 대상 위치를 묻습니다.

폴더처럼 열리는 Zip(.zip)

.zip은 자체 탭에서 열립니다: 왼쪽에는 구성원 트리(이름, 크기, 날짜), 오른쪽에는 선택한 구성원의 내용 — 텍스트/코드, Markdown (미리보기 포함), 이미지 또는 PDF — 이 디스크에 아무것도 추출하지 않고 메모리에서 열립니다. 텍스트와 Markdown은 편집할 수 있으며, Ctrl+S를 누르면 .zip 내부의 구성원이 그대로 다시 기록됩니다.

같은 탭에서 .7z, .rar, .tar(.tar.gz, .tar.bz2, .tar.xz 포함), .cab, .iso도 열립니다. 이들은 읽기 전용이라 탐색·보기·항목 추출은 되지만 편집은 되지 않습니다. 쓰기가 가능한 것은 .zip뿐인데, 안전하게 다시 쓸 수 있는 형식이 그것뿐이기 때문입니다(.rar는 독점 형식이라 자유 라이브러리도 압축하지 못합니다).

이미지와 PDF는 읽기 전용이며, 매우 큰 구성원(및 .parquet)은 추출…만 제공합니다. 구성원 생성, 이름 변경, 삭제는 지원하지 않습니다.

암호로 보호된 항목도 정상적으로 읽습니다. 하나를 열면 LightNote가 암호를 묻고(최대 세 번), "이 파일의 암호 기억하기"를 선택하면 다시 묻지 않습니다(기본적으로 같은 실행 중에, 선택하면 다음 실행에서도. Windows가 보호하며 이 컴퓨터의 사용자 본인만 사용합니다. 모두 지우기는 설정 → 기능). PDF와 다른 형식상의 차이에 유의하세요. .zip의 암호화는 항목 단위이고 목차는 평문으로 남기 때문에, 암호가 없어도 파일 목록은 그대로 보입니다. 보호되는 것은 내용뿐입니다. 암호화된 항목이 있는 .zip은 프로그램을 시작할 때 자동으로 다시 열리지 않습니다.

블록(.lnb)

블록 번들은 이름이 .lnb로 끝나는 폴더로, 트리에서 단일 항목으로 취급됩니다(더블클릭하면 열림). 각 블록은 디스크상의 실제 파일이며, 순서는 번들 루트의 blocks.json에 저장됩니다. 코드나 텍스트 셀이 쌓인 노트북처럼 동작합니다.

각 셀에는 이름, 유형 버튼(인터프리터/렉서 설정), 복사·삽입·삭제· 실행 버튼이 있습니다. 여기까지 실행은 현재 셀까지의 모든 코드 셀을 순서대로 실행합니다. 출력(stdout+stderr)은 해당 셀 바로 아래 패널에 나타납니다. 트리에서(새로 만들기) 또는 파일 → 새로 만들기로 생성할 수 있습니다.

Ctrl+Enter는 포커스가 있는 셀을 실행합니다 — SQL 편집기와 같은 동작입니다.

결과는 저장됩니다(실험 노트처럼). 실행이 끝나면 각 실행은 번들 안의 saida/<셀>/에 있는 .md 파일이 됩니다 — 실행 시각, 종료 코드, 소요 시간, 명령, 그리고 출력 자체가 담깁니다. Markdown이므로 어떤 편집기에서도 읽을 수 있고, 노트북과 함께 Git으로 버전 관리되며, AI 채팅에서도 찾을 수 있습니다. 번들을 다시 열면 패널 위에 마지막 실행 띠가 다시 나타납니다. 클릭하면 다시 실행하지 않고 결과를 볼 수 있습니다.

기록: 그 띠 옆의 기록 버튼은 해당 셀의 이전 실행(실행 시각과 종료 코드)을 나열합니다 — 같은 셀이 시간에 따라 무엇을 반환했는지 비교할 때 유용합니다. 셀당 최근 10개를 보관하며, 변경하려면 번들의 blocks.json에서 historyLimit 키를 편집하세요(0이면 저장을 끕니다). 아주 큰 출력은 잘립니다(파일에 truncated: true로 표시). 셀의 이름을 바꾸거나 유형을 변경하면 기록도 함께 이동하고, 셀을 삭제하면 기록은 휴지통으로 갑니다.

실제 데이터베이스에 대한 SQL 셀: 상단 띠(연결 선택…)에서 노트북을 .lnc 연결로 지정하면 sql 유형의 셀이 인터프리터가 아니라 데이터베이스에서 실행됩니다. SELECT 결과는 출력 파일 안의 표가 되고(진짜 Markdown이라 어떤 뷰어에서도 서식이 적용되어 보입니다), INSERT/UPDATE 등은 몇 행이 바뀌었는지 알려줍니다. 데이터베이스 오류는 스크립트를 중단하고 실패한 문을 기록합니다. 쿼리당 최대 100행을 가져옵니다(더 있었다면 파일에 표시) — 결과는 표의 사본이 아니라 기록입니다.

연결은 blocks.json에 상대 경로로 저장되므로 폴더를 옮기거나 동기화해도 노트북은 계속 동작합니다. 자체 완결형 노트북을 원한다면 .lnc 자체를 번들 안에 두세요. 설정으로 취급되어 셀이 되지 않습니다. 데이터베이스 탭과 같은 연결이므로 한쪽에서 연결하면 다른 쪽에도 적용되며, 비밀번호는 암호 문구 규칙을 따릅니다. 연결을 지정하지 않으면 sql 셀은 이전처럼 설정된 인터프리터로 실행됩니다.

작업(칸반 / 간트)

작업 번들(.lnt)은 칸반(상태 열, 카드 드래그), 간트(노력량 기반 일정), 캘린더 뷰가 있는 작업 보드를 엽니다. 각 작업은 제목, 열(상태), 작업 시간(시간 단위), 연결된 .md 노트를 가질 수 있습니다. 작업은 MCP와 CLI를 통해 AI로도 접근할 수 있습니다(생성, 이동, 갱신, 노트 읽기/쓰기).

작업별 필드: 상태와 작업 시간 외에도 각 작업에는 우선순위 (카드 테두리 색상 지정, 표 정렬 기준), 마감일(기한 초과 시 빨간 칩), 다중 태그, 하위 작업 체크리스트(카드의 진행 뱃지), 반복(반복 작업 완료 시 다음 항목 생성)이 있습니다. 컨텍스트 메뉴(표/칸반)와 속성 패널에서 편집합니다.

캡처와 목록: 트레이의 빠른 작업은 자연어를 이해합니다 (예: Pay bill tomorrow 5pm #home !high. 날짜·시각·우선순위를 나타내는 단어는 영어와 포르투갈어로 인식됩니다). 템플릿 버튼은 작업 템플릿을 저장/적용하고, 마감일 목록은 오늘/향후 7일/기한 초과로 필터링하며, 저장된 보기는 필터+정렬을 저장합니다. 트레이/런처는 오늘 또는 기한이 지난 작업에 대한 알림을 표시합니다.

칸반 보드: 열을 상태, 우선순위, 태그로 그룹화하고, 스윔레인을 만들고, 열별 WIP 한도를 설정하고(초과 시 헤더가 빨간색으로 표시) 카드를 정렬할 수 있습니다. Linear 스타일 키보드 탐색: ←/→로 포커스 이동, Ctrl+←/→로 카드 이동, N으로 생성, Space로 완료/재개, Delete로 삭제. 마감일 기준 캘린더 뷰도 있습니다.

내장 노트: 작업을 선택하면 뷰 옆에 해당 .md 노트가 표시되며(작업 전환 시 자동 저장), 노트 버튼으로 편집기를 켜고 끌 수 있고 탭에서 노트 열기는 노트를 별도 탭으로 엽니다. 작업을 보관하면 모든 뷰에서 숨겨지고, 보관된 항목 표시 토글을 켜면 보관된 작업이 흐리게 다시 나타납니다.

작업 설정에서 완료된 작업을 N일 후 보관을 지정할 수 있습니다. 보드를 열 때 마지막 열에 그보다 오래 있던 작업은 자동으로 보관됩니다(0 = 꺼짐).

노트는 기본적으로 내장되어 열리며(작업을 더블 클릭) 입력하는 동안 자동 저장됩니다. 작업은 닫을 때 "저장하시겠습니까?"라고 묻지 않습니다. 노트 안에서도 AI 동작(Ctrl+K / Ctrl+I)을 사용할 수 있습니다.

탭 도구 모음. 선택한 작업에 의존하는 동작(삭제, 의존 관계, 기록 (Git))과 CSV 내보내기는 ⋮ 버튼에 모였습니다. 보기 버튼에는 마감일별 목록, 저장한 보기, 보관된 항목 표시가 들어 있으며 모두 표에 적용됩니다. Ctrl+F는 빠른 필터에 포커스를 주고, 오른쪽 카운터는 필터 후 남은 작업 수를 보여 줍니다.

사용자 지정 표(.lnd)

사용자 지정 표(.lnd, 파일 → 새로 만들기에서 생성)는 나만의 미니 데이터베이스입니다: 실행 중에 열을 정의하고 (텍스트, 숫자, 날짜, 색상이 있는 고정 목록, 경로, 태그, 비밀번호) 스프레드시트처럼 행을 채우며 정렬과 필터링을 사용할 수 있습니다. 경로 필드는 행을 트리 형태로 그룹화합니다(예: 집/사무실).

비밀번호 셀은 암호 구문으로 개별 암호화되며 필요 시 표시됩니다. 작업과 마찬가지로 번들은 Git 친화적 텍스트(NDJSON)로 저장되어 — 여러 기기 간에 버전 관리와 병합이 가능합니다.

텍스트 열에서 셀을 열면 떠 있는 여러 줄 편집기가 나타납니다: Enter는 줄바꿈을 삽입하고 Ctrl+Enter는 확정합니다. 그리드에는 텍스트가 한 줄로(… 포함) 표시되며 전체 내용은 툴팁에 나타납니다. 열의 유형을 변경하려면 헤더 메뉴를 사용하세요: 텍스트 → 비밀번호 변환은 값을 암호 구문으로 암호화하고, 비밀번호 → 텍스트 변환은 확인과 PIN/암호 구문을 요구한 뒤 내용을 평문으로 씁니다(되돌릴 수 없음). 다른 변환은 값을 그대로 유지합니다.

베이스(노트 저장 쿼리)

베이스(.lnq, 파일 → 새로 만들기 → 새 베이스)는 노트에 대한 저장된 쿼리입니다. 유형과 속성으로 필터링하여 결과를 테이블 또는 보드로 봅니다. 베이스는 데이터를 전혀 저장하지 않습니다 — 행은 여러분의 .md 노트이며, 각 셀의 진실의 원천은 노트의 frontmatter입니다. .lnq를 삭제해도 노트는 하나도 잃지 않습니다.

셀을 편집하면 노트에 기록됩니다. 테이블에서 속성을 바꾸면 해당 파일 frontmatter의 그 줄만 다시 씁니다. 보드에서 카드를 다른 열로 끌면 그룹화 속성의 새 값이 기록됩니다 (예: 읽는 중에서 읽음으로).

각 노트는 frontmatter에 속성을 선언합니다(type, status, author 등). 노트의 속성 사이드 패널을 사용하면 원시 YAML 대신 형식이 있는 필드(텍스트, 숫자, 날짜, 체크박스)로 편집할 수 있습니다 — Markdown 노트를 참고하세요.

.lnq는 NDJSON(한 줄에 한 레코드)이며 Git을 염두에 두고 설계했습니다. 두 대의 컴퓨터가 같은 베이스를 동시에 편집해도 — 한쪽은 열을 추가하고 다른 쪽은 필터를 조정 — 병합이 두 변경을 충돌 없이 모두 유지합니다.

선언된 스키마(선택). LightNote는 기본적으로 노트가 실제로 사용하는 내용에서 각 유형의 필드를 유추합니다 — 아무것도 선언할 필요가 없습니다. 스키마를 고정하고 싶다면 도구 → 노트 유형...(또는 노트 속성 미니 바의 톱니바퀴 버튼)을 열어 각 유형의 필드, 데이터 유형(텍스트·숫자·날짜·확인란·선택 목록), 기본 템플릿을 선언하세요. 스키마가 있으면 선택 목록 필드는 허용된 값만 담은 드롭다운이 되고, 선언된 필드는 아직 어떤 노트도 사용하지 않았더라도 베이스의 열· 필터 선택기에 나타나며, 유형 템플릿 적용 버튼이 노트의 뼈대를 넣어 줍니다. 스키마는 .lightnote/types.ndjson에 있으며, 병합 가능한 NDJSON으로 노트와 함께 Git으로 버전 관리됩니다. 삭제해도 노트는 바뀌지 않고 다시 유추로 돌아갈 뿐입니다.

파일 검색과 대기 항목

사이드바의 검색 탭에서 전역 검색을 사용하려면 Ctrl+Shift+F를 누르세요. ripgrep 기반으로 정규식, 대소문자 구분, 온전한 단어, 일괄 바꾸기를 지원합니다. 현재 파일 안에서는 Ctrl+F로 찾고 Ctrl+H로 바꿉니다.

강조와 표시는 서로 다른 것입니다. 빠른 찾기(Ctrl+F)는 일치 항목을 호박색으로 강조할 뿐입니다. 일시적이며 막대를 닫거나 입력란을 비우면 사라집니다. 반면 편집 → 고급 찾기…의 모두 표시는 사용자의 결정입니다. 일치 항목을 빨간색으로 칠하고 해당 줄에 책갈피(여백의 파란 점)를 추가하며, 표시 지우기를 사용할 때까지 남습니다. 둘은 독립적입니다. 빠른 찾기를 닫아도 표시해 둔 것은 지워지지 않고, 표시를 지워도 찾기 강조는 사라지지 않습니다. 둘 다 미니맵의 표시 띠에 각자의 색으로 나타납니다.

사이드바의 대기 항목 섹션은 코드의 TODO/ FIXME 표시와 작업 공간 Markdown 노트의 작업 (- [ ])을 한곳에 모아 클릭하면 해당 줄로 바로 이동합니다.

버전 관리(쉬운 Git)

버전 관리는 작업 공간별 선택 사항입니다. 도구 → 작업 공간 설정에서 활성화하면 LightNote가 Git 저장소를 (아직 없다면) 생성하고 버전 관리 사이드바(Ctrl+Shift+G)를 표시합니다.

자동 모드에서는 일반 설정에서 선택한 시점(저장 시, 탭 닫을 때, 창 닫을 때)에 LightNote가 스스로 버전(커밋)을 저장합니다. 수동 모드에서는 메시지를 작성하고 패널에서 버전을 저장합니다. 상태 표시줄 표시기는 상태(변경 없음, X개 변경됨 등)를 보여주며 클릭하면 작업 공간 설정이 열립니다. 각 파일의 diff를 보고 저장하지 않은 변경 사항을 복원(취소)할 수 있습니다.

자동화에는 폴더별로 3단계가 있습니다(작업 공간 설정에서): 수동(자동화 없음), 자동 커밋(스스로 버전을 저장하지만 동기화는 하지 않음), 완전 자동(커밋 그리고 동기화 — 커밋 후 푸시 + 주기적 풀; 프롬프트 없는 Git 자격 증명 필요)입니다. 패널에는 원격 저장소 대비 ↑ 보낼 항목 / ↓ 받을 항목을 보여주는 상태 줄이 있으며, 보낼 버전이 있을 때 메인 버튼이 커밋에서 동기화로 바뀌어 저장 후에도 동기화가 필요함을 알려줍니다.

Git 패널과 트리의 Git 메뉴에는 파일별 추가(git add)와 복원(git restore), 그리고 나란히 비교(전체 파일을 마지막 버전과 비교)가 있습니다.

스냅샷과 백업

버전 관리 패널의 ⋯ 메뉴(또는 도구 메뉴)에서:

• 스냅샷 생성: 현재 상태를 날짜/시간 라벨로 표시해 나중에 돌아올 수 있게 합니다.
• 스냅샷 복원: 스냅샷을 선택하고 방법을 고릅니다 — 기록을 유지한 채 파일만 되돌리기(권장), 그 시점까지 기록을 되감기, 또는 별도 사본으로 열기.
• 사본 내보내기(.zip): 전체 작업 공간을 하나의 파일로 압축합니다(프로젝트 표식 포함) — 전송이나 별도 보관용.
• 작업 공간 폴더 이동…: 루트를 디스크에서 이동시키고 세션과 레지스트리 경로를 조정합니다.

변경 사항 검토(체크포인트)

도구 → 변경 사항 검토…는 하나의 탭에서 기준점 이후 작업 공간에서 변경된 모든 것의 통합 diff를 보여줍니다: 왼쪽에는 추가/수정/삭제된 파일 목록, 오른쪽에는 선택한 파일의 diff. AI CLI 세션이 변경한 내용을 검토하고 작업을 수락하기 전에 확인하도록 설계되었습니다.

기준점은 마지막 버전(HEAD) 또는 체크포인트가 될 수 있습니다: 작업을 시작하기 전에 하나 만들고(탭 자체의 버튼) 나중에 비교하세요. 체크포인트는 커밋을 만들지 않으며 기록에 영향을 주지 않습니다. 해당 폴더에 버전 관리가 활성화되어 있어야 합니다.

묶음 댓글. AI 세션을 검토할 때 댓글 버튼(파일 목록의 컨텍스트 메뉴에도 있음)은 선택한 파일에 대한 의견을 적어 둡니다. 선택한 발췌에 고정됩니다. 의견은 목록에 쌓였다가, 세션으로 보내기를 눌러야만 한 번에 모두 CLI 터미널로 전달됩니다. 의도적입니다. 한 건씩 보내면 에이전트가 하나를 고치고 다른 하나를 망가뜨립니다. 각 회차는 다른 지적을 보지 못하기 때문입니다. 수정 후에도 의견은 목록에 남아 반영되었는지 확인할 수 있습니다. 해결됨을 표시하면 다음 발송에서 제외됩니다. 에이전트가 댓글한 영역을 다시 쓴 경우, 의견은 사라지지 않고 회색으로 표시됩니다. 전송은 상태 표시줄에서 확인되며, 휴면 중인 세션은 묶음을 받기 위해 자동으로 재개됩니다.

파일 비교(diff)

도구 → 두 파일 비교…는 두 파일을 나란히(편집기 두 개) 열고 줄 단위로 차이를 표시합니다. 비교는 읽기 전용입니다.

◀ / ▶ 버튼(또는 F8 / Shift+F8)으로 이전/다음 변경으로 이동합니다. Git 패널에서 파일을 저장된 버전과 나란히 비교할 수도 있습니다(HEAD 대 디스크).

코드 실행(F5)

도구 → 파일 실행(F5)은 현재 파일을 저장하고 확장자에 등록된 인터프리터에 따라 터미널에서 실행합니다. 기본값은 .py, .sh, .bat, .cmd, .sql을 포함하며, 설정 → 실행에서 인터프리터를 편집/추가할 수 있습니다.

명령은 {file}(파일), {folder}(폴더), {name}(이름)을 포함하는 템플릿입니다 — 예를 들어 Python의 경우: python {file}. Ctrl+Shift+Enter로 선택 영역/현재 줄만 터미널로 보낼 수도 있습니다. 블록의 각 셀도 같은 방식으로 실행됩니다.

실행 버튼에는 터미널이 여러 개 열려 있을 때 대상 터미널을 선택하고 기억하는 드롭다운이 있습니다.

클릭할 수 있는 오류. 출력 패널(F6)에서 파일:줄 형태의 참조가 링크가 됩니다. Ctrl+클릭이나 더블클릭하면 해당 위치로 파일이 열립니다. 파이썬 트레이스백, Node 스택, 컴파일러(gcc/clang/MSVC) 오류, 린터 출력에 모두 동작합니다. 디스크에 실제로 존재하는 경로만 링크가 되고 나머지는 일반 텍스트로 남습니다.

오류를 차례로 보기. 출력 패널에서 F8은 다음 오류로, Shift+F8은 이전 오류로 이동합니다(패널 표시줄에 버튼도 있습니다). 이동은 순환하며, 출력을 해당 위치까지 스크롤해 강조하고 파일을 정확한 지점에서 엽니다.

터미널과 AI CLI

명령별 상태 점. 실행한 각 명령 옆에 점이 나타납니다: 성공하면 파란색, 실패하면 빨간색(툴팁에 시간, 소요 시간, 종료 코드 표시). LightNote는 설정을 바꾸지 않고도 PowerShell과 Git Bash에서 이 기능을 자동으로 활성화합니다 — 설정 → 터미널 → 셸 통합에서 켜고 끌 수 있습니다. 다른 셸(cmd, WSL)이나 사용자 지정 명령에서는 점이 표시되지 않습니다.

Ctrl+'(미국 키보드 배열에서는 Ctrl+`도)로 통합 터미널(ConPTY 기반 완전한 VT 에뮬레이터)을 엽니다. 탭이 되어 창 영역 간에 이동할 수 있습니다. 사용 가능한 셸과 PATH에서 감지된 AI CLI(예: claude)는 설정 → 터미널과 설정 → AI 어시스턴트에서 설정합니다. 새 터미널 메뉴에서 AI CLI를 선택하면 해당 CLI가 터미널 자체로서 열립니다 — TUI/색상이 정상적으로 표시되고 종료하면 탭이 닫힙니다.

전송 예약. 터미널 컨텍스트 메뉴(우클릭)의 전송 예약…은 나중에 Enter(또는 텍스트)를 전송하도록 설정합니다 — 사용량 한도가 초기화될 때 AI CLI를 다시 시작하는 데 유용하며, 지켜보지 않아도 됩니다. 트리거를 선택하세요: 특정 시각, 몇 분 후, 매 간격마다(반복), 또는 터미널이 유휴 상태가 될 때. 실행될 때까지 컴퓨터는 깨어 있는 상태로 유지됩니다. 예약은 터미널 탭이 열려 있는 동안 유지됩니다.

여러 예약을 동시에 둘 수 있습니다. 예약이 있으면 메뉴 항목이 예약된 전송 (N)…으로 표시되고 관리자가 열립니다: 터미널, 전송 내용, 시각, 다음 발동까지의 실시간 카운트다운을 보여주는 표와 새로 만들기, 편집, 제거 버튼이 있습니다. 예약이 있는 동안 상태 표시줄에 개수가 표시된 시계 표시기가 나타나고(클릭하면 관리자가 열림) 작동 중인 터미널 탭에도 작은 시계 표시가 붙습니다.

AI 턴 종료 알림. AI CLI 터미널이 조용해지면 — 에이전트가 턴을 마쳤다는 신호입니다 — LightNote가 알려 줍니다. 토스트가 뜨고(클릭하면 그 터미널로 이동합니다) 탭이 몇 번 깜빡인 뒤, 열어 볼 때까지 강조 표시가 남습니다. 창이 뒤에 있으면 작업 표시줄 버튼도 깜빡입니다. 이 알림은 AI CLI 터미널에만, 그리고 해당 탭에 포커스가 없을 때만 동작합니다. 켜기/끄기와 무음 판정 시간은 설정 → 터미널 → AI 턴 종료 알림에서 조정하세요.

터미널은 창과 함께 돌아옵니다. 작업 공간을 닫았다가 다시 열면 일반 셸 터미널(명령 프롬프트, PowerShell, Bash)이 다시 열립니다. 그것도 터미널이 처음 열렸던 폴더가 아니라 작업하던 폴더에서 열립니다. 화면 내용은 돌아오지 않지만 명령 기록은 셸 자체의 것이라 그대로 남아 있어 ↑ 키는 평소처럼 동작합니다. AI 어시스턴트 세션은 제외되며 계속 따로 물어봅니다. 새 터미널은 같은 대화가 아니기 때문입니다. 환경 변수나 그 세션에서 손으로 활성화한 환경(예: venv)도 돌아오지 않습니다. 터미널은 올바른 폴더에서 열리지만 새 셸입니다.

선택 영역에 대한 AI 어시스턴트(Ctrl+K / Ctrl+I)

기본 AI. 설정 → AI 어시스턴트 상단의 기본 AI는 Ctrl+K/Ctrl+I, AI 채팅 채팅(세션별로 변경 가능) 및 자동 작업(질문 다시 쓰기, 요약, 오디오 요약, 컨텍스트 생성)에서 사용하는 어시스턴트를 선택합니다. CLI와 API 공급자를 모두 나열합니다. 오디오 전사와 embeddings는 자체 공급자가 있으며, LightNote는 선택한 공급자에 따라 모델을 제안합니다.

편집기에서 Ctrl+K(AI에게 질문)나 Ctrl+I(AI로 편집)를 누르면 — 선택 영역이 있든 없든 — 인라인 채팅 스타일의 떠 있는 팝업이 열립니다: 프롬프트 입력란에는 빈 줄 아래로 선택 영역이 미리 채워지며, 그 위에 지시문을 입력하고 Ctrl+Enter로 전송합니다. 팝업에서는 AI(기본값이 미리 선택됨)와 결과 모드를 선택합니다: diff를 통해 선택 영역을 바꾸기(원본 × 제안, 수락 / 복사 / 거부 포함) 또는 답변을 텍스트로 표시만 하기.

LightNote는 AI CLI를 "원샷" 모드로 실행합니다(터미널을 열지 않음). CLI와 기본 AI는 설정 → AI 어시스턴트에 있습니다.

API를 통한 모델. 로컬 CLI 외에도 설정 → AI 어시스턴트에서 OpenAI 호환 API(OpenAI, Groq, DeepSeek, OpenRouter, Gemini, Anthropic, Ollama/LM Studio 같은 로컬 인스턴스 등)를 통해 LLM 모델을 등록할 수 있습니다. 카탈로그에서 제공자를 선택하면(기본 URL 자동 입력) 키를 붙여넣고(이 기기에만 인코딩되어 저장됨) 모델 가져오기…와 테스트를 사용하세요. 등록된 모델은 CLI와 함께 동일한 Ctrl+K 선택기에 나타납니다.

한 단계로 연결하기. 보통은 표를 채울 필요가 없습니다. 설정 → AI 어시스턴트에서 AI 연결…을 클릭하고 공급자를 고른 뒤(목록에는 무료 요금제 있음인 것과 내 컴퓨터에서 실행, 키 불필요인 것이 표시됩니다) 세 단계를 따라 버튼으로 키 발급 페이지를 열고 키를 붙여넣으세요. 주소와 모델은 LightNote가 알아서 채우고 저장하기 전에 연결을 테스트합니다. 잘못된 키는 대화 도중이 아니라 그 자리에서 드러납니다. 위쪽 목록에는 이미 연결된 항목과, 빠진 것이 있는 항목에서 무엇이 빠졌는지(“키를 붙여넣지 않음”, “모델을 선택하지 않음”)가 표시되며, 두 번 클릭하면 해당 공급자로 연결 창이 다시 열립니다.

세부 조정. 주소, 모델, MCP 권한, CLI 명령, 음성 전사, 임베딩은 모두 페이지 아래의 고급에 그대로 있습니다. 연결 창 안의 고급 옵션에서도 연결하기 전에 기본 URL과 모델을 바꿀 수 있습니다. 없앤 것은 없습니다. 처음 시작하는 사람의 앞길에서 비켜 놓았을 뿐입니다.

아직 연결된 AI가 없다면. 어시스턴트를 연결하지 않은 상태에서 Ctrl+K를 누르면 LightNote가 상황을 설명하고 바로 연결할 수 있도록 안내합니다. 연결하는 즉시 요청한 작업이 이어서 실행되므로 단축키를 다시 누를 필요가 없습니다.

로컬 LLM(키 불필요). 로컬 공급자 — Ollama, LM Studio, llama.cpp — 는 API 키가 필요 없습니다. 추가에서 하나를 고르고(서버 실행 여부가 목록에 표시됩니다), 모델 가져오기…로 이미 받아 둔 모델 중에서 선택하세요. Ollama가 설치돼 있지 않으면 LightNote가 설치를 도와줍니다. 첫 실행 때 이미 등록돼 있으므로 모델만 고르면 됩니다. 로컬 모델은 응답이 훨씬 오래 걸릴 수 있어(특히 모델을 불러오는 첫 생성 시), LightNote는 클라우드 서비스보다 훨씬 오래 기다립니다. 사용자의 텍스트는 기기 밖으로 나가지 않습니다.

블록 단위로 수락. 결과가 diff로 표시되면 전부 수락할 필요가 없습니다. 변경된 각 블록에는 포함 여부를 정하는 체크박스가 있고, 최종 텍스트는 남긴 블록만으로 다시 구성됩니다. 프롬프트에는 파일의 자동 컨텍스트(경로, 언어, 선택 주변 줄)도 담겨, 아무것도 붙여넣지 않아도 AI가 더 정확하게 답합니다.

프롬프트 라이브러리. AI → 프롬프트 라이브러리…는 재사용할 프롬프트를 작업 공간의 Prompts/ 폴더 안 .md 파일로 보관합니다 — 개방형 형식이고, Git으로 버전 관리할 수 있으며, 당신의 두 번째 뇌의 일부가 됩니다. 선택 창에는 검색, 미리 보기, 새 프롬프트 만들기 버튼이 있습니다. 하나를 고르면 {selection}, {file}, {folder}, {name}, {language} 항목이 현재 편집기의 맥락으로 채워지고(직접 만든 변수는 그대로 남습니다), 본문이 Ctrl+K 입력란에 들어가거나 활성 AI 터미널로 전송됩니다(제출하지는 않습니다).

코드 편집기에서만이 아닙니다. AI 동작(Ctrl+K / Ctrl+I 및 컨텍스트 메뉴)은 Markdown 편집기, 작업의 내장 노트, 데이터베이스의 SQL 쿼리 편집기에서도 사용할 수 있습니다. 각 경우 팝업이 커서 위에 열리고 결과를 그 자리에 적용합니다.

모든 AI 동작은 AI 메뉴에 있습니다(☰ 버튼과 활동 표시줄의 지팡이 버튼): AI에 질문(Ctrl+K), AI로 편집(Ctrl+I), AI 세션, AI 채팅, 프롬프트 라이브러리, 프로젝트 컨텍스트 파일 생성, 이 폴더에서 AI 활성화, AI 도우미 설정.

AI 세션

AI → AI 세션…은 어느 LightNote 창에서 열린 AI CLI 터미널이든 세션별 카드로 모아 보여주는 콕핏을 엽니다. 색상 상태 점, CLI 이름, 창, 그리고 주의가 필요한 항목의 배지(예약된 전송, 격리 사본)가 함께 표시됩니다. 더블 클릭으로 터미널을 포커스하고, 카드의 ⋯ 메뉴(또는 오른쪽 클릭)에서 해당 세션의 변경 사항을 검토하거나(세션이 시작될 때 만들어진 체크포인트를 기준으로 검토 화면을 엽니다 — 변경 검토 참조), 전송을 예약할 수 있습니다. 여러 “바이브 코딩” 세션을 창 사이에서 헤매지 않고 동시에 지켜보는 방법입니다.

Git 저장소 안에서 AI CLI를 터미널로 열면 LightNote가 자동으로 체크포인트(라벨 “세션 …”)를 저장하므로, 그 세션이 무엇을 바꿨는지 나중에 정확히 확인하고 되돌릴 수 있습니다. 이 기능은 설정 → 일반 → 기능에서 끌 수 있습니다.

격리 사본(worktree): Git 폴더에서 LightNote는 AI 어시스턴트를 폴더의 격리 사본(전용 브랜치)에서 실행할 수 있어, 손으로 편집하는 파일을 건드리지 않습니다. 처음에는 물어보고 이후에는 자동입니다(작업 공간 설정 → 통합에서 폴더별로 켜고 끔). 격리 사본 배지가 해당 세션을 표시하며(브랜치와 경로는 툴팁에 있습니다), 병합… 항목(변경 사항을 폴더로 가져옵니다 — 보류 중인 변경이 있으면 먼저 물어봅니다)과 버리기…(사본과 브랜치를 버림)로 주기를 마무리합니다.

유휴 세션 알림. AI CLI가 유휴 상태가 되면(완료했거나 입력을 기다림) LightNote가 알림을 표시하고, 클릭하면 해당 세션의 변경 사항 검토가 열립니다. 작업을 시작하고 자리를 비울 수 있습니다. 설정 → 터미널에서 끌 수 있습니다.

프로젝트 컨텍스트 파일. 컨텍스트 파일(CLAUDE.md 또는 AGENTS.md)이 없는 폴더에서 AI CLI를 열면 LightNote가 생성을 제안하며, 도구 → 프로젝트 컨텍스트 파일 생성…에서 언제든 만들 수 있습니다. 좋은 컨텍스트 파일은 프로젝트의 구조와 규칙을 설명해 매 세션마다 다시 설명하지 않아도 AI가 실수를 덜 하도록 돕습니다. AI 공급자가 설정되어 있으면 그것이 내용을 생성하고, 없으면 채워 넣을 골격이 제공됩니다.

유휴 세션 휴면. 멈추어 있는 AI CLI도 메모리(대화와 모델 클라이언트)를 계속 쥐고 있습니다. 설정 → 터미널에서 무음 시간을 지정하면 LightNote가 프로세스를 종료하고, 해당 탭에 돌아오면 스스로 재개합니다 — 터미널 기록은 화면에 그대로 남습니다. 기본값은 30분으로 켜져 있으며(측정 결과 멈춰 있는 Claude Code 세션 3개가 1 GB 이상을 차지했습니다), 격리된 사본에서 동작하고 폴더의 대화를 재개할 수 있는 CLI(현재 Claude Code와 Antigravity)의 세션에만 적용됩니다. 그렇지 않으면 재개 시 다른 세션의 대화를 가져오게 됩니다. 예약 전송이 있는 세션은 절대 휴면에 들어가지 않습니다. 또한 돌아오는 것은 대화이지 도구의 화면이 아닙니다. 입력했지만 보내지 않은 텍스트는 사라집니다.

활동 탭. 표는 지금 실행 중인 것을 보여주고, 활동 탭은 기록을 남깁니다. 에이전트가 차례를 마친 때, 격리된 사본에서 시작한 때, 휴면한 때마다 날짜와 마지막 응답의 발췌가 함께 남습니다. 읽지 않은 항목은 굵게 표시되고, 개수는 트레이 메뉴에도 나타납니다 — 알림은 금방 사라지므로, 자리를 비운 사람도 놓친 것을 확인할 수 있습니다. 탭을 열면 모두 읽음으로 표시되며, 두 번 클릭하면 해당 세션으로 돌아갑니다. 세션의 종료도 이벤트로 남습니다(CLI가 스스로 끝난 경우 포함). 자리를 비운 사이 끝난 세션이 흔적 없이 사라지지 않습니다. 이벤트의 세션이 더 이상 열려 있지 않으면 두 번 클릭했을 때 아무 일도 없는 대신 그 사실을 알려 줍니다.

AI 채팅

AI → AI 채팅…는 자신의 노트를 컨텍스트로 사용해 답하는 채팅을 엽니다. 모든 것을 클라우드로 보내는 대신, LightNote는 볼트에서 가장 관련 있는 발췌를 로컬로 가져와(ripgrep 사용, 임베딩이나 외부 서비스 불필요) 그 발췌로 질문을 구성한 뒤, 등록해 둔 API AI 제공자에게 보냅니다. 답변에는 출처 노트가 클릭 가능한 인용으로 함께 제공되며, 클릭하면 노트가 열립니다. “두 번째 뇌와 대화하며” 이미 적어 둔 내용을 다시 찾기에 좋습니다. 대화 기록은 메모리에만 유지되며(저장되지 않음), 이 기능은 설정 → 일반 → 기능에서 끌 수 있습니다.

창 구성. 선택기는 상단의 한 줄 막대에 모여 있습니다. AI, 노트 폴더, 그리고 — 텍스트 편집기가 활성일 때 — 컨텍스트입니다. 오른쪽에는 두 가지 권한(도구와 변경 허용)과 새 대화를 시작하는 + 버튼이 있습니다. 첫 질문 전에는 창이 무엇에 대해 답할지를 화면이 알려 주고, 이 폴더 요약 같은 한 번의 클릭 단축키를 제공합니다. 질문 칸에서는 Enter가 보내기, Shift+Enter가 줄바꿈입니다. 답변이 오는 동안에는 보내기 버튼이 중지로 바뀝니다.

AI가 도구를 쓰게 하기. 변경 허용 확인란은 동작을 바꿉니다. 키워드 검색으로 가져온 발췌만으로 답하는 대신, 모델이 스스로 찾아보고(파일 읽기, 노트 검색, 작업 목록) 나서 답합니다. 켜면 LightNote가 선택한 모델이 도구를 호출할 수 있는지 즉시 확인합니다. 많은 제공자가 요청은 받아들이면서 도구를 그냥 무시하는데, 이 확인이 없으면 조사한 것처럼 보이는 꾸며낸 답이 나옵니다. 판정은 제공자와 모델 조합별로 7일간 기억됩니다. API 제공자가 필요합니다(로컬 CLI는 도구를 받을 수 없습니다). 답변 끝에 실제로 사용한 목록이 나오므로, 믿는 대신 판단할 수 있습니다. 판정이 부정적이면(그 순간 공급자가 단순히 다운되어 있었을 수도 있습니다) 메시지 옆에 다시 확인 버튼이 나타나, 저장된 결과를 무시하고 테스트를 다시 실행합니다.

AI가 내 것을 바꾸게 하기. 두 번째 확인란 변경 허용은 별개의 단계이며 꺼진 상태로 시작합니다. 켜면 AI가 노트와 작업을 만들고 속성을 바꾸며 오늘 노트에 기록할 수도 있지만, 확인 없이는 아무 일도 일어나지 않습니다. 변경은 대화에 쉬운 말로 나타나고("작업 빵 사기 만들기") 허용과 거부가 함께 표시됩니다. 거부해도 대화는 끝나지 않습니다. 모델에 전달되어 설명하거나 다른 방법을 제안하며 이어집니다. 읽기는 확인을 묻지 않고, 변경만 묻습니다. 임의 파일 덮어쓰기와 네트워크 접근은 의도적으로 제외했습니다. AI가 읽기만 하는 한, 외부에서 동기화된 노트에 섞여 들어온 악의적 문장이 디스크의 변경으로 바뀔 길이 없습니다. 변경이 오늘의 노트에 기록하는 것이라면, 요청에는 어느 폴더에 들어갈지도 함께 표시됩니다. 대상 파일이 AI의 요청에 들어 있지 않은 유일한 쓰기이기 때문입니다.

메모냐, 열려 있는 파일이냐. 창 상단의 컨텍스트: 콤보에서 대화의 대상을 선택합니다. Vault 노트(기본값, 아래 설명)이거나 현재 편집기입니다. 후자는 vault 대신 편집기에서 열린 파일에 대해 답하며, 선택 영역과 주변 줄(또는 전체 파일 체크 시 파일 전체)을 사용합니다. 이렇게 같은 창으로 메모에 대해서도, 편집 중인 코드에 대해서도 여러 차례 대화할 수 있습니다. 현재 편집기 범위는 텍스트 편집기가 활성일 때만 나타납니다. 또한 빠른 어시스턴트(Ctrl+K)에서는 결과에 채팅에서 계속 → 버튼이 있어, 이 창을 현재 편집기 범위로 다시 열고 그 회차의 질문과 답변을 이어받습니다 — 처음부터 다시 하지 않고 더 깊이 파고들 수 있습니다.

어떤 노트인가요? 이 창은 하나뿐이며 한 번에 한 폴더에 대해 답합니다. 상단 막대에서 AI 선택기 옆의 노트 위치: 콤보가 대상을 보여 주고 선택합니다. 채팅을 연 창의 폴더가 처음부터 선택되어 있고, 지금 열려 있는 폴더와 그 뒤에 최근 폴더가 나열됩니다. 폴더 선택…으로 그 밖의 폴더도 지정할 수 있습니다. 폴더를 바꾸면 이후 질문에 적용되므로, 다른 프로젝트에서 작업하면서 어떤 프로젝트의 노트에 대해 AI 채팅을 할 수 있습니다. 직접 고른 폴더는 다시 바꿀 때까지 유지됩니다(창을 다시 열어도 범위가 되돌아가지 않습니다). 질문이 진행 중인 동안에는(확인을 기다리며 멈춰 있을 때도 포함) AI·컨텍스트·폴더 선택기가 잠깁니다. 돌아오는 답은 질문할 당시의 모델과 폴더에 속하기 때문입니다.

질문하는 방법. 검색은 지시가 아니라 주제로 이루어집니다. LightNote는 질문에서 단어를 뽑아 그 단어가 들어 있는 노트를 찾습니다. "Postgres에 대해 무엇을 적었지?"처럼 노트에 나오는 주제를 말하세요. "요약해 줘" 같은 막연한 요청은 검색할 내용 단어가 없어 아무것도 검색되지 않으며, 답변이 노트를 사용하지 않았다고 채팅이 알려 줍니다. .md/.markdown 노트만 읽으며, 그런 파일이 하나도 없는 폴더에서는 채팅이 이를 알리고 AI 호출을 소비하지 않습니다.

더 나은 검색·요약·다시 쓰기. 검색은 BM25 순위의 로컬 색인을 사용해 악센트를 무시하고("configuração"로 "configuracao"를 찾음), 단어 사이에 공백이 없는 언어(일본어·중국어·한국어)에서도 작동합니다 — 색인을 만드는 동안에는 ripgrep이 보조합니다. 이 폴더 요약 버튼은 구체적인 질문이 없을 때 모든 노트의 개요를 만듭니다. 그리고 설정 → 일반 → 기능의 AI로 질문 다시 작성 옵션은 검색 전에 질문을 키워드로 확장합니다(질문마다 API 호출 1회).

키 하나면 됩니다. 처음 실행할 때 LightNote는 OpenAI, Google Gemini, Anthropic (Claude)를 설정 → AI 어시스턴트에 이미 등록해 둡니다. 사용하는 제공자에 API 키만 붙여넣으면 됩니다. 키가 있는 제공자가 없으면 창에 지금 설정 버튼이 나타나 해당 화면을 바로 엽니다.

대화가 보관됩니다. 상단의 시계 버튼을 누르면 해당 폴더의 이전 대화 목록이 열립니다. 하나를 누르면 그 대화로 돌아갑니다. 새 대화는 현재 대화를 지우지 않고 보관하며, 목록에서 오른쪽 버튼을 누르면 하나를 완전히 삭제합니다(확인 후). 대화는 폴더별로 저장되므로 노트 폴더를 바꾸면 목록도 바뀝니다.

답변으로 무엇을 할까. 각 답변 아래에 복사(서식을 그대로 유지한 마크다운 텍스트를 클립보드로)와 노트에 담기(인용된 노트 링크와 함께 오늘의 노트로)가 있습니다. 대화 작업 메뉴에는 대화 복사, 대화를 노트로 저장…(조회한 폴더에 .md 기록), 마지막 답변 다시 생성, 마지막 질문 편집이 있습니다.

파일 첨부하기. 검색이 생각하던 것을 찾지 못할 때는 + 버튼으로 파일을 첨부하세요. 첨부한 것은 검색 순위 경쟁과 무관하게 항상 질문에 들어갑니다. 노트, 코드, 텍스트, PDF를 지원합니다(PDF는 텍스트를 추출). 바이너리는 그 자리에서 거부되어 컨텍스트의 잡음이 되지 않습니다. 첨부는 알약 모양으로 표시되며(클릭하면 해제) 새 대화를 시작하면 사라집니다. 지원하는 공급자에서는 답변도 모델이 쓰는 대로 조금씩 나타납니다.

HTTP API 테스트(.lnh)

도구 → 새 API 테스트(.lnh)…는 .lnh 파일로 저장되는 HTTP 클라이언트를 엽니다. 하나의 파일은 엔드포인트(메서드, URL, 헤더, 본문)를 나타내며 왼쪽 목록에 여러 테스트를 보관합니다 — 각 테스트는 URL, 헤더, 본문에서 사용하는 {name} 변수 값과 마지막 실행 결과(상태, 시간, 날짜, 응답 헤더와 본문)를 가집니다. 동등한 curl 명령도 함께 표시됩니다. 같은 일회성 작업은 CLI(http)와 MCP (http_request)에서도 사용할 수 있습니다.

Ctrl+Enter로 요청을 보냅니다.

OpenAPI 가져오기와 내보내기. 테스트 목록 위쪽의 화살표 버튼에서 OpenAPI 가져오기…와 OpenAPI 내보내기…를 열 수 있습니다. 가져오기는 YAML 또는 JSON 명세를 읽으며, 현재 쓰이는 세 세대 — Swagger 2.0, OpenAPI 3.0, 3.1 — 를 모두 지원하고 테스트를 알아서 구성합니다. 경로의 {매개변수}는 .lnh의 {이름} 변수와 문법이 같아 그대로 쓰이고, 명세에 선언된 예시는 테스트 값이 되며, 보안 스킴은 Authorization 헤더가 되고, 선언된 서버마다 별도의 테스트가 만들어집니다(검증 환경과 운영 환경을 나란히). 한 .lnh 파일은 엔드포인트 하나를 담으므로, 작업이 여러 개인 명세는 어느 것을 가져올지 묻습니다. 또는 한 번에 전부 저장해 작업마다 .lnh 파일을 하나씩 만들 수도 있습니다.

내보내기는 그 반대 방향으로, 파일에서 OpenAPI 3.0.3 명세를 만듭니다. 서버·매개변수·본문은 템플릿에서, 예시 응답은 기록된 실행에서 나옵니다. 이는 뼈대이지 완전한 계약이 아닙니다 — .lnh는 호출을 기술하므로 타입, 설명, 스키마는 복원되지 않습니다. 테스트는 x-lightnote-tests 필드에 함께 담기므로 파일을 다시 가져오면 그대로 돌아옵니다.

curl 명령 가져오기. 같은 버튼의 curl 명령 가져오기…를 누르면 붙여 넣기 상자가 열립니다. 명령은 디스크가 아니라 거기에서 오며, 클립보드에 curl이 있으면 미리 채워집니다. 같은 명령이 유통되는 세 가지 방언을 이해합니다. Chrome/Firefox의 cURL로 복사(작은 따옴표), Windows의 Copy as cURL (cmd)(^ 사용), 그리고 \로 줄을 나눈 문서 예시입니다. 메서드는 -X에서 가져오며, 없으면 본문이 있을 때 POST, 없을 때 GET으로 판단합니다.

가져오기는 있는 그대로 이루어집니다. 어떤 값도 저절로 {이름} 변수가 되지 않습니다. 어느 토큰이 비밀인지 추측하면 틀리기 때문입니다. 몇몇 경우에는 얼버무리지 않고 알려 줍니다. 파일에서 오는 본문(-d @파일)은 읽을 수 없고, 멀티파트 업로드(-F)도 그대로 재현되지 않으므로 해당 항목은 조정할 수 있도록 본문에 텍스트로 들어갑니다.

데이터베이스(.lnc)

연결은 작업 공간 안의 .lnc 파일(LightNote Connection)로 표현됩니다 — Git으로 버전 관리 가능하며 기기 간 이동도 가능합니다. 새로 만들기 → 새 연결(또는 기존 .lnc 열기)로 생성하면 데이터베이스 뷰가 열립니다. 여기에는 연결 상태 표시줄(연결/연결 해제/재연결/편집), 스키마 트리(스키마 → 테이블 → 열, 필요 시 로드), 내부 .sql 탭이 있습니다. 열려 있던 .sql 파일과 최근 항목은 .lnc 내부에 저장되어, 뷰가 이전 상태 그대로 다시 열립니다. 아무것도 열려 있지 않았다면 제목 없는 빈 쿼리로 시작해 바로 SQL을 입력할 수 있습니다. 저장 시(Ctrl+S) LightNote는 이름만 물어보고 파일을 프로젝트 폴더 안에 씁니다("아무 곳에나 저장" 대화상자 없음). + 탭 버튼은 새 빈 쿼리를 열거나, 파일 열기(선택 대화상자가 프로젝트 폴더에서 시작)를 하거나, 최근 항목이나 프로젝트 폴더의 모든 .sql 파일을 선택할 수 있게 합니다.

트리에서 바로 연 .sql은 코드만 표시됩니다(SQL 강조, 연결 없음).

드라이버: SQLite와 DuckDB(파일)는 네이티브 지원; PostgreSQL, MySQL/MariaDB, SQL Server, 범용은 ODBC를 통해; Oracle은 ODBC 없이 네이티브로 지원됩니다. SQL Server는 Microsoft의 msodbcsql 드라이버를 사용하며(기기에 설치 필요) Windows 인증 또는 사용자/비밀번호 방식과 채널 암호화 옵션(Encrypt / 인증서 신뢰)을 제공합니다. Oracle의 경우 일반 설정 → 데이터베이스에서 Oracle Instant Client 폴더를 지정하세요 — 설치할 필요 없이 실행 시 로드됩니다. Oracle 연결에는 네 가지 모드가 있습니다: 서비스 이름(호스트/포트/서비스), SID(호스트/포트/SID), TNS 이름(클라이언트 폴더의 tnsnames.ora 별칭), 전체 TNS 설명자(텍스트 필드에 붙여넣기).

비밀번호: 비밀번호 저장을 체크하면 .lnc 파일 내부에 암호화되어 저장됩니다(다른 기기에서도 열리는 이동 가능한 암호화). 체크하지 않으면 비밀번호는 저장되지 않고 연결할 때마다 물어봅니다. 암호화에는 도움말 → 암호 구문 설정에서 지정한 작업 공간별 암호 구문을 사용합니다. 안전하게 보관하세요 — 이것이 없으면 다른 곳에서 비밀번호를 열 수 없습니다. 암호 구문은 로컬 기기에만 캐시되며(Git으로 전송되지 않음) 유지됩니다.

열 때 연결을 체크하면 .lnc를 열 때 연결이 자동으로 시작됩니다. 자동 연결은 조용하게 진행됩니다: 비밀번호를 입력해야 하는 경우(묻기 모드, 또는 이 기기에 암호 구문이 캐시되지 않은 암호화 모드) 방해 없이 연결 해제 상태로 열립니다.

실행: Ctrl+Enter는 커서 위치의 문을 실행하고 Alt+X는 스크립트 전체를 실행합니다. 결과는 페이지 단위로 표시되며, 각각 결과 탭과 하단 작업 바를 가집니다: 다음 블록 가져오기 또는 모든 행 가져오기, 전체 개수, 행 제한 변경, 새로고침(재실행), SQL 보기/복사, 내보내기..., 선택한 행에서 SQL 생성.

결과 그리드: NULL은 빈 문자열과 구분되도록 흐린 기울임꼴로 표시되고 숫자는 오른쪽으로 정렬됩니다. 여러 셀을 선택하면 바닥글에 선택 개수가 표시되고, 숫자인 경우 합계와 평균도 표시됩니다. 바닥글 막대의 값 패널 버튼(또는 컨텍스트 메뉴의 패널에서 값 보기)은 선택한 셀의 전체 값을 자르지 않고 보여 주는 측면 패널을 열며, 서식 버튼으로 표시할 때만 JSON/XML을 정리합니다. 셀의 컨텍스트 메뉴에서 이 값으로 필터 / 이 값 제외는 해당 셀에 WHERE를 붙여 쿼리를 다시 실행하고, 참조된 레코드로 이동은 열의 외래 키를 따라 셀 값으로 부모 테이블을 조회합니다.

실행 계획: 도구 모음의 실행 계획 버튼은 커서 위치 문의 EXPLAIN을 표시합니다 (SQLite, DuckDB, PostgreSQL, MySQL). 단일 문으로 계획을 제공하지 않는 데이터베이스(SQL Server, Oracle)에서는 버튼이 비활성화되고 이유가 툴팁에 표시됩니다.

객체 속성: 스키마 트리에서 테이블을 더블 클릭하면(또는 F4, 컨텍스트 메뉴의 속성) 객체 구조가 네 개의 하위 탭으로 열립니다: 열(번호, 이름, 유형, NULL 허용, 기본값, 기본 키 열에는 키 아이콘), 키(기본 키·외래 키·고유·체크 제약. 외래 키를 더블 클릭하면 참조된 테이블이 열립니다), 인덱스, DDL — 객체의 CREATE TABLE로, 복사하거나 .sql로 저장하거나 편집 가능한 탭에서 열 수 있습니다. 데이터베이스가 완성된 DDL을 제공하지 않을 때(PostgreSQL과 SQL Server에는 해당 명령이 없습니다) LightNote는 메타데이터에서 재구성합니다(DDL 명령이 권한 부족으로 거부될 때도 마찬가지입니다). 그리고 그 사실을 탭에 명확히 표시합니다. 열 카탈로그조차 읽을 수 없으면(권한이 없거나 카탈로그를 사용할 수 없음) 재구성할 재료가 없습니다. 이때 탭은 조용히 비어 있는 대신 그 이유를 알려 줍니다. 테이블의 컨텍스트 메뉴에는 탭을 열지 않고 DDL 복사도 있습니다.

스키마 트리: 스키마 트리는 테이블과 뷰를(각각 고유한 아이콘으로) 구분하고, 기본 키에 속한 열에 키 아이콘을 표시합니다. 필터 상자는 이미 불러온 객체만 걸러냅니다(필터만을 위해 지연 로딩이 강제되지는 않습니다).

스키마 탐색: 테이블을 우클릭하면 SELECT를 편집기에 삽입, 데이터 미리보기, 행 개수, 정규화된 이름 복사를 선택하거나 SQL 생성 하위 메뉴를 열어 INSERT/UPDATE/MERGE를 선택할 수 있습니다: 테이블의 열 목록이 표시되어 포함과 키를 체크할 수 있고, 실시간 미리보기가 표시되며 편집기에 명령이 삽입됩니다(MERGE는 ANSI 형식으로 생성되며, 드라이버가 지원하지 않으면 경고가 표시됩니다). 결과 그리드에서는 하단 바의 SQL 생성 버튼으로 선택한 행의 값이 채워진 INSERT/UPDATE/DELETE를 만듭니다(단일 테이블 SELECT 쿼리일 때만 사용 가능). 트리에서 탐색한 테이블과 열 이름은 추가 데이터베이스 조회 없이 해당 연결의 .sql 편집기 자동완성(Ctrl+Space)에도 나타나기 시작합니다.

결과 내보내기: 결과 그리드를 우클릭하고 결과 내보내기...를 선택하면 CSV(구분자, 따옴표 문자, 항상 따옴표, 헤더 행, NULL 텍스트), JSON Lines 또는 SQL(테이블 이름이 포함된 INSERT문)로 저장할 수 있으며, 행 개수 제한도 선택할 수 있습니다. 내보내기는 화면에 보이는 것뿐 아니라 전체 쿼리를 스트리밍 방식(페이지 단위 재조회)으로 처리합니다.

스크립트 변수: 스크립트 줄에 @set 이름 = 값을 사용해 변수를 정의합니다 — @ 접두사 덕분에 실제 데이터베이스와 충돌하지 않습니다(Postgres/DuckDB/SQL Server의 실제 SET과 겹치지 않음). :이름 형태의 참조는 실행 전에 치환됩니다 (문자열과 주석 밖에서; ::타입 캐스트와 :1 같은 바인드는 그대로 유지됨). 값이 없는 :이름은 실행 전에 입력 창을 엽니다. 도구 모음의 변수 버튼은 정의된 변수 화면을 엽니다(편집/추가/제거).

쿼리 기록: 기록 버튼은 이 연결에서 성공적으로 실행된 최근 문을 SQL / 시각 / 소요 시간 / 행 수 열로 보여주는 창을 엽니다. 항목을 선택해 다시 실행, 편집기에 삽입, 복사(더블클릭으로 삽입)를 하거나 기록 지우기를 사용할 수 있습니다. 로컬 기기에만 저장되며(Git에도, .lnc에도 가지 않음) 유지됩니다.

트랜잭션: 도구 모음에는 자동 커밋 버튼(기본 켜짐)과 커밋/롤백 버튼이 있습니다. 자동 커밋을 끄면 커밋으로 확정하거나 롤백으로 취소할 때까지 변경 사항이 대기 상태로 유지되며, 트랜잭션이 열린 채로 연결을 끊으면 어떻게 할지 묻습니다.

SSH 연결(.lns)

SSH 연결은 .lnc처럼 작업 공간 안의 .lns 파일입니다 — 버전 관리와 이동이 가능합니다. 새로 만들기 → 새 SSH 연결로 생성하면 탭에 통합 SSH 터미널(Windows의 ssh.exe 사용)과 원격 파일 미니 바(SFTP)가 열립니다.

파일 탐색기는 한 번에 폴더 하나를 보여줍니다(MobaXterm/WinSCP 스타일): 첫 번째 행은 항상 상위 폴더로 이동하는 ..이며, 폴더를 더블클릭하면 들어갑니다. 상단 경로 바에서 원격 경로를 입력하고 Enter를 눌러 이동할 수 있습니다. 터미널과 동기화 버튼은 표시되는 폴더가 SSH 세션의 현재 디렉터리(터미널에서 cd한 위치)를 따라가게 합니다. 우클릭 메뉴에는 편집기에서 열기(파일을 다운로드해 탭에서 열고 저장 시 다시 업로드), 다운로드, 업로드, 새 폴더, 이름 변경, 삭제, 권한(chmod) 항목이 있습니다. Explorer에서 파일을 패널로 드래그해서 현재 폴더에 업로드할 수도 있습니다.

비밀번호는 작업 공간의 암호 구문으로 .lns 파일 내부에 암호화하거나 연결할 때마다 물어보게 설정할 수 있습니다. Windows 에이전트/프로필의 SSH 키는 정상적으로 작동합니다. 연결이 시스템의 OpenSSH 클라이언트를 사용하기 때문입니다.

연결 대화상자의 열 때 연결 옵션은 .lns를 열 때 SSH 세션을 자동으로 시작합니다. 비밀번호가 저장되어 있지 않으면 터미널이 연결 시 직접 물어봅니다.

보안: 암호 구문, PIN, 보안 Markdown

암호 구문은 도움말 → 암호 구문 설정…에서 작업 공간별로 설정하며, LightNote가 암호화하는 모든 것 — 연결 비밀번호 (.lnc/.lns), 사용자 지정 표의 비밀번호 셀, .lne 파일 — 의 열쇠가 됩니다. 암호화는 강력하고 이동 가능합니다(Argon2id + XChaCha20-Poly1305): 암호화된 파일은 같은 암호 구문을 다시 입력하면 다른 기기에서도 열립니다. 안전하게 보관하세요 — 이것이 없으면 암호화된 데이터를 복구할 수 없습니다. 암호 구문은 로컬 기기에만 캐시되며(Git으로 전송되지 않음) 유지됩니다.

암호 구문을 변경하려면 같은 화면을 열고 암호 구문 필드를 수정하세요(현재 값이 미리 채워져 있습니다). 확인하면 LightNote는 작업 공간의 모든 보안 데이터 — .lnc/.lns의 비밀번호, .lne 파일의 내용, 사용자 지정 표(.lnd)의 비밀번호 셀 — 를 이전 암호 구문에서 새 암호 구문으로 자동으로 재암호화합니다. 복호화는 전부 아니면 전무입니다: 하나라도 복호화에 실패하면 아무것도 변경되지 않고 LightNote가 어떤 항목인지 알려줍니다. 쓰기 단계에서는 각 파일을 다시 쓰기 전에 백업으로 복사합니다. 쓰기에 실패하면 LightNote가 모두 취소(백업 복원)할지 해당 파일을 건너뛰고 계속(이전 암호 구문 유지, 마지막에 경고 표시)할지 물어봅니다. ("묻기" 모드의 비밀번호는 재암호화할 것이 없습니다.)

PIN(4~8자리)은 선택적인 로컬 잠금입니다: 매번 암호 구문을 입력하지 않고도 민감한 UI 동작(비밀번호 표시, 보안 노트 열기)을 보호합니다. 아무것도 암호화하지 않으며 이 기기에만 적용됩니다.

보안 Markdown 파일(.lne, 새로 만들기 → 보안 Markdown 파일에서 생성)은 디스크에 암호화되어 저장되는 노트입니다: 열 때 LightNote는 (설정되어 있다면) PIN과 암호 구문을 물어보고 메모리에서만 복호화한 뒤 저장 시(Ctrl+S) 다시 암호화합니다. 안전을 위해 세션이 복원될 때 스스로 다시 열리지 않습니다.

일일 노트, 빠른 캡처, 트레이

오늘의 노트는 Daily Notes 폴더(LightNote 전체에 하나뿐이며 설정 → 메모와 글쓰기에서 지정)에 하루에 하나씩 생성되는 .md 파일입니다. 트레이 메뉴에서: 오늘의 노트는 그날의 노트를 열고, 빠른 캡처…(Ctrl+Alt+N, 전역 Windows 단축키 — 또는 트레이 아이콘 가운데 클릭)는 입력하고 Ctrl+Enter를 누르는 작은 창을 엽니다: 텍스트는 편집기 창을 열지 않고도 디스크에 바로 기록되어 오늘의 노트에 타임스탬프가 붙은 항목으로 저장됩니다.

트레이 메뉴에는 열린 창 목록과 최근 작업 공간, 그리고 전원 토글(컴퓨터 절전 방지와 화면 켜짐 유지, 긴 작업에 유용 — LightNote는 원샷 AI, 블록 셀, SQL 스크립트를 실행하는 동안 이미 스스로 전원을 유지함)도 있습니다. 런처(시작 창)에는 검색, 더블클릭으로 열기, 맨 위에 고정·Explorer에서 열기·목록에서 제거를 위한 컨텍스트 메뉴가 있습니다.

LightNote 전체에 적용되는 동작은 — 지금 있는 창에만 해당하는 것이 아니므로 — 일반 메뉴(☰ 일반 또는 활동 표시줄의 앱 아이콘 버튼)에 모여 있으며, 트레이 메뉴와 완전히 같은 구조입니다: 최상위에 오늘의 노트, 빠른 캡처, 달력. 이어서 하위 메뉴 캡처(빠른 작업, 오디오 녹음, 오래된 노트 다시 만나기, 스티커 메모), 열기(런처, 작업 공간 열기, 개별 파일 열기, 개별 파일), 전원. 마지막으로 일반 설정. 규칙은 간단합니다: 트레이 메뉴에 있는 것은 일반 메뉴에 있습니다 — 그리고 거기에만 있습니다. 항목에 마우스를 올리면 “일반 기능: 어느 창에서든 LightNote 전체에 적용됩니다”라는 안내가 표시됩니다.

캡처가 저장되는 곳. 일일 노트와 빠른 작업의 대상은 하나로 정해져 예측 가능합니다: 설정 → 메모와 글쓰기에서 정한 폴더와 설정 → 일반에서 정한 보드이며, 어느 창에서나 같습니다. 아무것도 정해지지 않은 상태에서 처음 캡처하면 LightNote가 어디에 보관할지 묻고 그 선택을 저장합니다 — 설정을 찾아 헤매게 하지 않습니다. 자체 일지가 필요한 프로젝트(기밀 유지가 필요한 고객, 저장소에 있어야 하는 기록)는 작업 공간 설정 → 캡처에서 그 창의 캡처를 가져갈 수 있습니다. 트레이와 전역 단축키는 계속 일반 대상에 기록합니다. 확인 알림은 항상 텍스트가 어디로 갔는지 알려 줍니다.

트레이 메뉴는 일부러 짧게 유지합니다. 최상위에는 열린 창과 매일 쓰는 세 가지 동작 — 오늘의 노트, 빠른 캡처, 달력 — 만 남습니다. 나머지는 일반 메뉴와 같은 하위 메뉴에 있습니다: 캡처, 열기(트레이에서는 최근 작업 공간 목록도 포함), AI(AI 세션, AI 채팅 — 창에서는 완전한 AI 메뉴), 전원. 마지막으로 설정과 종료입니다.

오래된 노트 다시 찾기

“제2의 뇌”가 실패하는 가장 큰 이유는 기능 부족이 아니라 다시 읽지 않는 노트입니다. 트레이 메뉴(캡처 섹션)에서 LightNote는 오래된 노트를 다시 불러옵니다. 무작위 노트는 작업 공간의 .md 노트를 무작위로 열고(최근 2주에 표시된 것은 제외), 그날은 생성 기념일이 오늘(과거 연도의 같은 월·일)인 노트를 나열합니다. 두 작업 모두 창의 일반 → 캡처 메뉴에도 있습니다.

생성 날짜는 frontmatter의 created/date 필드가 있으면 그곳에서, 없으면 파일 날짜에서 가져옵니다. 이 기능은 노트에 절대 쓰지 않습니다 — 열기만 합니다. 설정 → 기능(“오래된 노트 다시 찾기”)에서 끌 수 있습니다.

휴대폰에서 노트 사용하기

작업 공간은 폴더 안의 순수 Markdown입니다 — 개방형 형식으로, 독점 데이터베이스나 필수 클라우드가 없습니다. 그래서 어떤 휴대폰 앱이든 여러분의 노트를 읽고 편집할 수 있으며, LightNote가 전화용 전용 앱을 필요로 하지 않습니다. 폴더를 동기화한 뒤 휴대폰의 Markdown 편집기에서 열기만 하면 됩니다.

단계별로: 작업 공간 폴더를 OneDrive, Google Drive, Dropbox 또는 Syncthing으로 동기화하고, 휴대폰에서 그 폴더를 Markdown 편집기(예: Obsidian Mobile, iA Writer, GitJournal 또는 Markor)로 엽니다. 모든 것이 텍스트인 .md이므로 양쪽에서 같은 노트를 보고 씁니다.

권장 사항: 휴대폰에서는 .md 파일만 편집하세요 — LightNote 고유 형식(보안 .lne, .lnc, .lnt, .lnb, .lnd…)은 앱 밖에서 열리지 않으며, 특히 .lne는 암호화되어 있습니다. 양쪽이 오프라인으로 편집하여 충돌이 생기면 Inbox 폴더로 해결하세요. 캡처(텍스트, 오디오 또는 사진)를 거기에 넣고 덮어쓰는 대신 LightNote가 그날의 노트에 통합하도록 하세요. 이 배치는 의도적입니다 — 동기화는 파일/Git로 이루어지며 플러그인으로 하지 않습니다. 데이터는 여러분의 것이고 전송 방식도 여러분이 선택합니다. 오늘의 노트에 바로 쓰고 싶다면 데일리 노트/yyyy-mm-dd.md 파일을 편집하세요 — 폴더 이름은 언어에 따라 달라집니다.

오디오 녹음(음성·회의)과 AI 전사

트레이 메뉴의 오디오 녹음…을 누르면 떠 있는 드래그 가능한 창이 열려(제목 표시줄을 끌어서 이동) 마이크, 시스템 오디오(컴퓨터에서 재생되는 소리) 또는 둘 다를 동시에 녹음할 수 있습니다 — 선택한 소스는 다음번을 위해 기억됩니다. ● 녹음, ‖ 일시정지, ■ 정지를 사용하며, 파일은 작업 공간의 녹음 폴더에 저장되고 정지 시 .m4a로 압축됩니다.

두 가지 전사 방식. 설정 → AI 어시스턴트 → 오디오 전사의 전사 방법 선택기에서 전용 전사 모델(Whisper 방식: OpenAI whisper-1, Groq whisper-large-v3(무료) 또는 로컬 Whisper)과 채팅에 오디오를 넣는 일반 모델 중에서 선택합니다. 후자는 오디오를 멀티모달 모델의 대화에 넣는 방식으로, Google Gemini(gemini-2.0-flash, 좋은 무료 플랜)가 이렇게 전사합니다. 공급자를 바꾸면 알맞은 모드가 미리 선택되고 모델이 제안됩니다. 긴 오디오는 어느 모드에서든 자동으로 분할됩니다. 제안된 모델은 직접 입력해 바꿀 수 있으며, LightNote는 아직 인식하지 못하는 공급자라도 입력한 id를 존중합니다.

녹음을 시작하면 창이 저절로 작은 알약형 막대(깜빡이는 빨간 점, 타이머, 일시정지/정지)로 접혀 회의 중에 구석으로 끌어다 두고 거의 숨겨둘 수 있습니다. 제목의 최소화/확장 버튼으로 수동으로도 전환할 수 있으며, 정지하면 다시 펼쳐집니다. Ctrl+Alt+R(전역 단축키)은 빠른 음성 메모용입니다 — 누르면 즉시 마이크 녹음을 시작하고, 다시 누르면 정지합니다. 마우스로 창을 열 필요가 없습니다.

API 기반 AI 공급자가 구성되어 있으면(설정 → AI 어시스턴트 → 오디오 전사) 정지 시 전사와 전사 + 요약 버튼이 나타납니다(오디오가 아직 압축 중일 때는 비활성화). 정지 시 콤보를 사용하면 녹음이 끝나자마자 전사가 자동으로 시작되게 할 수 있습니다. LightNote가 오디오를 보내 전사하고(Whisper 계열 모델), 오디오 옆에 본문과 선택적으로 요약을 담은 .md 노트를 만듭니다. 이 기능은 설정 → 일반 → 기능에서 켜고 끌 수 있습니다.

같은 창은 미니 플레이어이기도 합니다. 컨트롤 아래에 폴더의 녹음 목록이 표시되며, 각 파일에는 (있는 경우) T(전사 열기)와 R(요약 열기) 버튼, 그 자리에서 재생하는 ▶(탐색 가능한 진행 막대)가 함께 표시됩니다. 각 행의 ⋮ 메뉴에서 재생·(재)전사·노트 열기를 할 수 있습니다. 전사를 다시 생성해도 이전 것을 덮어쓰지 않고 옆에 새 버전(note.md, note (2).md…)을 만들어 기록을 보존합니다. 캡처 소스는 메뉴 버튼(마이크 / 시스템 오디오 / 둘 다)이며 기본값은 둘 다입니다. 녹음 폴더 열기 링크는 메인 창에서 폴더를 엽니다.

스티커 메모

스티커 메모는 Windows의 스티커 메모 앱 스타일로 바탕 화면 위에 떠 있는 작은 색상 순수 텍스트 상자입니다. 트레이 메뉴에서: 새 스티커 메모(Ctrl+Alt+S, 전역 단축키)는 상자를 만들고, 스티커 메모 표시(Ctrl+Alt+H)는 모두 한 번에 표시하거나 숨깁니다. 각 노트에는 다른 노트를 만드는 +와 색상 변경, 오늘의 노트로 보내기(텍스트를 오늘의 노트에 항목으로 기록하고 상자를 없앰), 삭제를 위한 ☰ 메뉴가 있습니다. 헤더를 드래그해 이동하고 모서리 손잡이로 크기를 조절합니다. 노트는 자동으로 저장되며 LightNote를 다시 열면 다시 나타납니다.

캘린더

일반 → 캘린더…는 등록된 모든 .lnt 보드의 작업이 있는 날짜를 표시하는 캘린더가 있는 단일 창을 엽니다. 옆에는 선택한 날짜의 작업을 보여주는 오늘 목록과 대기 목록이 있으며, 그날의 노트 버튼은 해당 날짜의 일일 노트를 엽니다. 작업을 클릭하면 해당 보드가 열립니다.

그리드에서 작업이 있는 날짜에는 칸반 상태 색상의 점이 최대 세 개까지 표시되고, 오늘은 링으로, 선택한 날짜는 채워진 원으로 표시됩니다. 오늘은 현재 달로 돌아가고, 월 이름을 누르면 달이나 연도를 옮기는 메뉴가 열립니다. 보류 중 항목은 상황별로 기한 초과, 오늘, 향후 7일, 이후, 날짜 없음으로 묶이며, 마감일은 “어제”, “오늘”, “3일 전”처럼 상대적인 배지로 표시됩니다. 날짜를 두 번 누르면 그 날짜가 들어간 빠른 작업이 열립니다.

명령 팔레트

Ctrl+Shift+P는 명령 팔레트(단축키가 함께 표시되는 모든 동작, 입력으로 필터링 가능)를 엽니다. Ctrl+P는 빠른 파일 선택기를, Ctrl+Shift+K는 작업 선택기를 엽니다.

MCP 서버(AI 에이전트)

LightNote에는 작업 공간을 AI 에이전트용 도구(Claude Desktop, Claude Code, Cursor 등 MCP를 지원하는 모든 클라이언트)로 바꾸는 헤드리스 MCP(Model Context Protocol) 서버가 포함되어 있습니다. 에이전트는 파일을 읽고 쓰고, 검색하고, 표 형식 데이터와 데이터베이스를 조회하고, 작업을 다루고, Git을 사용하고, HTTP 요청을 보낼 수 있습니다 — 모두 해당 폴더로 제한됩니다(디렉터리 감옥: ..가 포함되거나 루트 밖의 경로는 거부됨). 전송 방식은 stdin/stdout을 통한 JSON-RPC 2.0이며, 세션마다 편집기 창과 별개로 가벼운 lnote.exe 프로세스가 실행됩니다.

원클릭 바로가기: AI → 이 폴더에서 AI 사용을 선택하면 LightNote가 MCP를 켜고 .mcp.json을 한 번에 씁니다(클릭이 곧 동의입니다). 폴더에서 AI가 이미 활성화되어 있으면 이 항목은 이 폴더의 AI 설정…으로 바뀌고 작업 공간 설정을 엽니다.

이중 안전 장치: (1) 해당 폴더에 대해 사전 동의한 경우에만 서버가 시작됩니다; (2) 모든 도구는 작업 공간 루트로 제한됩니다. 추가로 각 도구는 주석(읽기 전용, 파괴적, 멱등, "외부 세계에 영향")과 함께 안내되어 AI 클라이언트가 호출 전에 위험을 판단할 수 있습니다.

단계별 설정

1. 폴더에 MCP 활성화. 도구 → 작업 공간 설정에서 이 작업 공간에 MCP 활성화를 체크하세요. 이 사전 동의 없이는 서버가 시작을 거부합니다(주요 관문입니다). 또는 명령줄에서: lnote --mcp-enable "C:\Path\to\workspace" (끄려면 --mcp-disable).
2. lnote.exe의 경로 찾기. lightnote.exe와 같은 폴더(앱 설치 폴더)에 있습니다. UI가 없는 "슬림" 콘솔 실행 파일로, 에이전트가 실행하는 대상입니다.
3. AI 클라이언트에 서버 등록 — 명령을 lnote.exe로 지정하고 --mcp와 작업 공간 폴더를 인자로 전달합니다. Claude Desktop / Cursor 등에서 사용하는 형식으로는:

{
  "mcpServers": {
    "lightnote": {
      "command": "C:\\Path\\to\\lnote.exe",
      "args": ["--mcp", "C:\\Path\\to\\workspace"]
    }
  }
}

설정 팁:

• 예제처럼 JSON의 백슬래시는 두 번 써야 합니다 (C:\\Users\\...\\lnote.exe).
• 여러 작업 공간을 노출하려면 폴더마다 항목을 하나씩 추가하되, 각각 고유한 이름("lightnote-projectA", "lightnote-projectB")을 사용해 자신의 루트를 가리키게 하세요.
• 설정을 저장한 뒤 AI 클라이언트를 재시작해 서버를 시작하게 하세요. 연결되면 에이전트가 lightnote_* 도구를 나열할 수 있어야 합니다. "작업 공간 파일을 나열해줘"라고 물어보아 동작을 확인하세요.
• Claude Code(CLI)의 경우 같은 서버를 claude mcp add lightnote -- "C:\Path\to\lnote.exe" --mcp "C:\Path\to\workspace"로 등록할 수 있습니다.

데이터베이스 비밀번호(선택 사항). db_query 도구는 .lnc 연결을 엽니다. 비밀번호가 암호 문구로 암호화되어 있다면 서버 블록에서 LNOTE_PASSPHRASE 환경 변수로 구문을 전달하세요(명령줄 인자로는 절대 전달하지 마세요) — 비밀번호가 "묻기" 모드인 연결은 자동으로 사용할 수 없습니다.

AI 쿼리는 연결별 옵트인입니다. 폴더에서 MCP를 켜도 연결이 노출되지 않습니다. 각 .lnc는 연결 대화상자에서 “AI 쿼리 허용 (MCP)”이 켜져 있을 때만 db_query에 응답합니다. 접근은 읽기 전용(SELECT)입니다.

에이전트를 통한 데이터베이스 내보내기. 조회뿐만 아니라 db_export로 SELECT를 파일로 구체화할 수 있습니다(Parquet, CSV, JSON 또는 .xlsx) — 응답에 담기에 너무 큰 결과에 유용합니다. 동일한 세 가지 안전장치가 이 순서로 적용됩니다: 쿼리는 읽기 전용이어야 하고, 연결에는 「AI 조회 허용(MCP)」 옵션이 필요하며(비밀번호를 복호화하기 전에 확인), 대상 경로는 작업 공간 안에 있어야 합니다. 대용량 내보내기는 시스템 임시 폴더를 작업 공간으로 사용하며 대략 결과물 크기만큼 차지합니다 — 디스크 공간을 확보하세요.

사용 가능한 도구

에이전트는 클라이언트의 접두사가 붙은 도구를 보게 됩니다(예: lightnote_read_file). 범주별로:

• 파일: read_file(줄 범위 지정 가능), write_file, edit_file(파일 전체를 다시 쓰지 않고 정확한 조각을 대체), append_file, list_files, move_file, make_dir, delete_file(완전 삭제가 아닌 휴지통으로 이동).
• 검색과 탐색: search_files(ripgrep, 하위 폴더/glob 필터와 개수 제한 포함), list_symbols(파일의 함수/클래스 개요), open_in_editor(LightNote 창이 열려 있으면 파일을 열거나 포커스).
• 데이터와 SQL: query(Parquet/CSV/JSON에 대한 DuckDB SQL, tsv/json/markdown 출력), describe_table (행을 덤프하지 않고 스키마+통계), export_query (COPY를 통해 SELECT를 파일로 구체화), sqlite_query (.sqlite/.db에 대한 SQL), db_list_connections (작업 공간의 .lnc 파일 나열), db_query (.lnc 연결에 대한 읽기 전용 SQL). 결과를 응답 대신 파일로 내보내려면 db_export(Parquet/CSV/JSON/.xlsx).
• 또한: search_notes(질문에 가장 관련성 높은 노트 조각을 검색 — AI 채팅과 같은 엔진), list_links(노트의 나가는 링크를, 해결됨/깨짐으로 표시), audit_vault_links(보관소 전체의 깨진 링크와 고아 노트), list_note_templates 와 create_note 의 template 매개변수, list_due_tasks(모든 프로젝트에서 오늘 마감이거나 기한이 지난 작업), xlsx_read(.xlsx 시트를 TSV로 읽기), data_diff(두 표 형식 파일 비교), 그리고 데이터베이스 카탈로그 db_list_objects/db_describe(테이블/뷰와 테이블의 열·키·DDL — db_query와 동일한 조건).
• 아카이브: zip_list(.zip/ .isx의 구성원 나열)와 zip_read(구성원을 텍스트로 읽기) — 디스크에 아카이브를 추출하지 않고 수행합니다.
• 작업: list_task_projects(작업 공간의 .lnt 작업 프로젝트 나열), list_tasks, list_task_statuses(보드 열), create_task, update_task, update_task_status(열 간 이동), delete_task, task_note(작업의 .md 노트 읽기/쓰기). 작업 공간에는 여러 .lnt 프로젝트가 있을 수 있습니다: project 매개변수(list_task_projects가 반환하는 name; 프로젝트가 하나뿐이면 생략 가능)로 선택하세요. id/ status_id는 세션 식별자입니다 — 이를 얻으려고 내부 .lnt 파일을 읽지 말고 작업 도구를 사용하세요.
• 노트(PKM): create_note(.md 노트 생성), append_daily_note(오늘의 노트에 캡처 추가), list_backlinks(노트를 가리키는 노트들), list_note_tags와 search_by_tag(저장소의 #해시태그와 이를 사용하는 노트들), add_task(제목에 자연어를 받아 마감일/태그가 있는 작업 생성).
• Git: git_status, git_log, git_diff, git_restore.
• 웹과 알림: http_request(HTTP 요청을 보내고 상태/헤더/본문 반환), notify(열린 창에 트레이 알림 표시 — 에이전트가 작업 완료를 알리는 데 유용).
• AI 프록시: list_ai_models와 ask_ai (아래 참고).

서버는 또한 작업 공간 파일을 MCP 리소스(resources/list와 resources/read)로도 노출합니다. read_file을 호출하는 대신 파일을 "첨부"하는 방식을 선호하는 클라이언트를 위한 기능입니다.

당신의 프롬프트 라이브러리(작업 공간의 Prompts/ 폴더)는 MCP 프롬프트로 공개됩니다(prompts/list 와 prompts/get). Claude Code에서는 각 프롬프트가 슬래시 명령 /mcp__lightnote__<이름>이 되어 AI CLI 안에서 바로 사용할 수 있습니다.

쓰기 안전망. 파일을 덮어쓰거나(write_file/edit_file) 삭제하기(delete_file) 전에, 서버는 이전 버전을 로컬 기록(에디터와 동일한 안전망)에 저장합니다. 따라서 Git 저장소 밖에서도 에이전트가 한 변경을 되돌릴 수 있습니다.

각 도구는 읽기인지 쓰기인지 명시합니다: MCP 주석 (readOnlyHint/destructiveHint) 외에도 설명이 [read-only], [writes], [destructive] 뱃지로 시작합니다 — 허용 목록을 안전하게 구성하는 데 유용합니다.

AI 프록시(다른 모델에 위임)

MCP 열이 체크된 상태로 등록한 API 제공자는 list_ai_models(허용된 모델을 id, 이름, model과 함께 나열)와 ask_ai({model, prompt}) 두 도구를 통해 에이전트에 노출됩니다. 이를 통해 메인 에이전트가 더 저렴하거나 특화된 모델에 하위 작업을 위임할 수 있습니다. 호출은 실행 중인 LightNote가 중개합니다(MCP의 lnote.exe가 내부 브리지를 통해 요청을 앱 창으로 전달): API 키는 절대 이 기기를 벗어나지 않으며 에이전트에도 전달되지 않습니다. LightNote가 열려 있지 않으면 도구는 열어달라고 요청하는 오류를 반환합니다.

명령줄(lnote)

같은 MCP 작업이 스크립트와 자동화를 위한 콘솔 실행 파일 lnote에도 있습니다(lightnote cli <command>로도 접근 가능). 모든 작업은 --root로 설정한 루트 폴더(기본값: 현재 폴더)로 제한됩니다.

예시:

lnote list --recursive
lnote read --path src/main.cpp --start-line 1 --end-line 40
lnote write --path note.md --content "Hello"
echo content | lnote write --path note.md --content -
lnote search --query TODO --regex
lnote query --sql "SELECT * FROM read_parquet('data.parquet') LIMIT 10"
lnote describe --path data.parquet
lnote search-notes --query "예산에 대해 어디에 적었는지"
lnote audit-links
lnote xlsx-read --path sheet.xlsx --sheet 0
lnote data-diff --a before.parquet --b after.parquet --mode changed --keys id
lnote db-describe --connection data.lnc --table customers
lnote db-export --connection dados.lnc --sql "SELECT * FROM clientes" --out clientes.parquet
lnote due-tasks
lnote export --sql "SELECT * FROM read_csv_auto('e.csv') WHERE state='NY'" --out ny.parquet
lnote zip-list --path export.isx
lnote zip-read --path export.isx --entry job/definition.xml
lnote task-projects
lnote tasks --project Backlog
lnote create-task --project Backlog --title "Review the text" --effort 2
lnote move-task --project Backlog --task-id 5 --status-id 2
lnote git-status
lnote http --url https://api.example.com --method GET
lnote notify --message "Processing finished"

전역 옵션: --root <folder>, --json (구조화된 {ok,data,error} 출력), --help(또는 lnote <command> --help), --version. 알 수 없는 명령에는 제안("혹시 이걸 찾으셨나요?")이 표시됩니다.

오래된 데이터 일괄 업데이트: lnote upgrade <폴더> 는 이전 버전의 LightNote가 기록한 파일을 한 번에 최신 형식으로 바꿉니다. 현재 대상은 .lns와 .lne로 바뀐 옛 확장자 .lnsh와 .lnsm입니다. 앱은 각 파일을 열 때 이미 이 작업을 자동으로 수행하므로, 이 명령은 파일이 수십 개여서 하나씩 열고 싶지 않을 때 사용합니다. --dry-run을 쓰면 아무것도 건드리지 않고 무엇이 바뀔지 미리 볼 수 있습니다. 필수가 아니라 편의 기능이며, 이 명령 없이도 예전 파일은 정상적으로 열립니다.

설정과 테마

도구 → 일반 설정에서 다음을 섹션별로 조정합니다: 일반 옵션(언어, 자동 저장, 유휴 탭 해제, 탭 색상 팔레트, 창 제목, 일일 노트, 맞춤법 검사), 애플리케이션 테마, 편집기 글꼴과 색상, Markdown 스타일, 실행(인터프리터), 터미널(셸), AI 어시스턴트(CLI와 기본 AI), 버전 관리, 데이터베이스 (페이지 매김, Oracle Instant Client).

섹션 목록 위에 있는 검색 필드는 각 페이지의 옵션으로 필터링합니다. 기능 섹션에는 선택적 기능의 스위치 — 연결 그래프, 스티커 메모, AI 세션, 노트에 묻기, 오디오 녹음, 오래된 노트 다시 찾기, 컴퓨터 절전 방지, Windows 탐색기 메뉴 통합 — 이 모여 있습니다. 기능을 끄면 인터페이스·트레이·단축키에서 사라지고 리소스 소비도 멈추지만 이미 만든 데이터는 유지됩니다. 변경은 다시 시작할 때 적용됩니다.

애플리케이션 테마는 프로그램의 외관(메뉴, 탭, 패널, 상태 표시줄)을 바꿉니다. 미리 준비된 테마가 여럿 있습니다 — 밝은 테마 (Light, Solarized Light, Catppuccin Latte, Gruvbox Light, One Light, Rosé Pine Dawn)와 어두운 테마(Dark, Tokyo Night, Dracula, Ayu Mirage, Nord, Gruvbox Dark) — 그리고 강조 색상을 지정하는 사용자 지정 모드가 있습니다. 새로운 테마는 애플리케이션을 업데이트하지 않아도 온라인 카탈로그를 통해 추가됩니다.

코드 편집기와 Markdown 색상은 애플리케이션 테마와 별개로, 각자의 섹션에서 따로 선택합니다. 각각 준비된 배색(Default, Dracula, One, Nord, Gruvbox, Tokyo Night — 밝고 어두운 변형 포함)이 있는 테마: 콤보, 실시간 미리보기, 나만의 색상을 재사용 가능한 프리셋으로 저장하는 다른 이름으로 저장… 버튼이 있습니다.

창별 테마. 각 폴더(작업 공간)는 자체 테마를 가질 수 있어, 서로 다른 모습의 창 두 개를 동시에 열어둘 수 있습니다. 작업 공간 설정 → 이 폴더의 외관에는 이 창의 테마(애플리케이션 모습), 코드 테마, Markdown 테마를 위한 콤보가 있으며, 각각 변경하지 않고 두는 일반 테마 따르기/기본값 유지 옵션이 있습니다. 코드와 Markdown 테마를 재정의하면 일반 설정을 건드리지 않고 해당 폴더에서만 편집기 색상을 어두운 테마에 맞출 수 있어 유용합니다. 이 선택은 이 기기에만 남고 Git에 커밋되지 않습니다.

설치 가이드. 카탈로그의 도구(AI 어시스턴트, 인터프리터, 포매터, 린터, 데이터베이스 드라이버) 중 아직 컴퓨터에 없는 것을 선택하거나, 인터프리터가 없는 파일을 실행/서식/검사하려고 하면 LightNote가 설치 가이드를 엽니다. 안전한 명령(winget 사용)이 있으면 가이드는 정확한 명령을 보여 주고 내장 콘솔에서 한 번의 클릭으로 실행합니다. 도구가 다른 것(예: Node.js가 필요한 CLI)에 의존하면 먼저 필수 구성 요소를 설치하도록 제안합니다. 자동 설치 프로그램이 없으면 가이드는 공식 다운로드 페이지를 열고 단계별 안내를 제공합니다. 완료되면 설치를 확인하고 프로그램을 다시 시작하지 않아도 도구를 사용할 수 있게 합니다.

서식과 린터는 각각 자체 섹션(카탈로그의 추가 기능이 있는 언어별 외부 포매터/린터)을 가지고 있습니다. 설정을 다른 기기로 옮기려면 설정 이전 그룹(일반 섹션)의 내보내기/가져오기 설정(.lnconf 파일)을 사용하세요: 일반 옵션과 콘텐츠 테마는 포함되지만 API 키나 로컬 경로는 포함되지 않으므로 대상 기기에서 다시 입력해야 합니다.

창 제목은 자유 형식 템플릿입니다: 앱 이름은 항상 끝에 오며, 나머지는 {workspace}(작업 공간 루트 폴더), {file}(열린 파일 이름), {path}(전체 경로) 변수로 구성합니다. 빈 변수 주변의 장식(예: [ {workspace} ]의 대괄호)은 스스로 사라집니다. 필드를 비워두면 기본값인 [ {workspace} ] {file} — 이 사용됩니다.

창 레이아웃. 보기 → 창 레이아웃(또는 일반 설정 → 일반 → 창 레이아웃)에서 세 가지 프리셋—모던(기본값), 클래식, 편안함— 중 하나를 고르거나 각 항목을 따로 조정할 수 있습니다. 상단에 메뉴 모음을 표시하기(켜면 ☰ 단추는 사라집니다. 둘 다 같은 메뉴를 열기 때문입니다), 아이콘 옆에 레이블을 표시하기, 도구 모음과 사이드바를 왼쪽이나 오른쪽에 두기, 그리고 아이콘 크기입니다. 프리셋은 항목을 채워 줄 뿐이며, 이후 개별로 바꿔도 취소되는 것은 없고 목록이 ‘(사용자 지정)’으로 바뀔 뿐입니다. 변경 사항은 열려 있는 모든 창에 즉시 적용됩니다.

키보드 단축키

• F1 — 이 도움말(현재 화면의 섹션으로)
• Ctrl+N / Ctrl+O — 새 파일 / 파일 열기
• Ctrl+S / Ctrl+W — 저장 / 탭 닫기
• Ctrl+Alt+Shift+S — 모두 저장(수정된 모든 탭)
• Ctrl+F / Ctrl+H — 파일 내 찾기 / 바꾸기
• Ctrl+Shift+F — 전역 검색(ripgrep)
• Ctrl+Shift+G — 버전 관리 패널(Git)
• Ctrl+Shift+E / Ctrl+Shift+M — 탐색기 패널 / 대기 항목 패널
• Ctrl+B — 사이드바 표시/숨기기
• Ctrl+' — 터미널(미국 배열에서는 Ctrl+`도)
• Ctrl+/ — 주석/주석 해제; Ctrl+Shift+D — 줄 복제
• F5 — 파일 실행; Ctrl+Shift+Enter — 선택 영역을 터미널로 전송
• Ctrl+K / Ctrl+I — AI에게 질문 / AI로 편집
• Ctrl+B / Ctrl+I / Ctrl+E — 마크다운 노트에서: 굵게 / 기울임 / 보기 모드 전환
• Ctrl+Enter — “여기서 실행”: SQL 문, 블록 셀, API 요청
• Ctrl+Shift+R / F4 — 매크로: 기록 / 재생
• Ctrl+P — 파일로 이동; Ctrl+Shift+P — 명령 팔레트
• Ctrl+Shift+K — 작업으로 이동; Ctrl+Shift+T — 닫은 탭 다시 열기
• Ctrl+Alt+G — 연결 그래프
• Ctrl+Alt+N — 빠른 캡처(전역, LightNote 밖에서도 동작)
• Ctrl+Alt+D / Ctrl+Alt+T — 오늘의 노트 / 빠른 작업
• Ctrl+Alt+R — 오디오 녹음/정지(전역, 빠른 음성 메모)
• F11 — 젠 모드(탭이 창 전체를 차지)
• Ctrl++ / Ctrl+- / Ctrl+0 — 확대/축소

필터링 가능한 전체 목록은 도움말 → 키보드 단축키에 있습니다.

라이선스, 에디션, 커뮤니티

LightNote는 동일한 기능을 가진 여러 에디션으로 제공되며, 라이선스와 배포 방식만 다릅니다:

• LightNote(무료, 웹사이트에서): 개인, 비상업적 용도로 사용.
• LightNote Core(Microsoft Store): 프로젝트에 대한 기여로 구매하며, 상업적 사용 라이선스가 주어지고 Store를 통해 자동 업데이트를 받습니다.
• LightNote Business(향후): 대량/기업용 라이선스로, 향후 제공 예정입니다.

보유한 사본의 에디션 — 그에 따라 적용되는 조항 — 은 도움말 → 정보에서 확인할 수 있습니다. 전체 약관은 도움말 → 정보 → 라이선스 약관…에 있습니다.

참여하고 기여하기:

• 제안과 질문: GitHub Discussions — github.com/nglczr/LightNote-Community/discussions
• 버그를 발견하셨나요? GitHub Issues에 신고해 주세요 — github.com/nglczr/LightNote-Community/issues
• Ko-fi로 개발을 후원해 주세요 — ko-fi.com/lightnote (또는 Store에서 LightNote Core 구매)
• 문의: contato@lightnote.com.br · 웹사이트: lightnote.com.br