LightNote Android 도움말

휴대폰 앱은 컴퓨터용 LightNote의 동반자입니다. 같은 노트 폴더를 열고, 같은 파일을 읽고 쓰며, 같은 코어로 저장합니다. Markdown, 작업 보드, 표, 카드를 다루는 코드는 양쪽이 같습니다. 휴대폰에서 쓴 내용은 변환 없이 컴퓨터에서 열리고, 그 반대도 마찬가지입니다.

설치와 업데이트 (미리 보기)

앱은 아직 Google Play에 없습니다. GitHub의 github.com/nglczr/LightNote-Android에서 APK로 배포하는 무료 미리 보기입니다. Android 9 이상, 64비트 ARM 휴대폰이 필요합니다.

설치. 휴대폰 브라우저로 .apk 파일을 내려받아 탭합니다. Android가 브라우저나 파일 관리자에서 앱 설치를 허용하라고 묻고, Play 프로텍트가 알 수 없는 개발자라고 경고할 수 있습니다.
출처 확인. LightNote의 모든 APK는 같은 키로 서명됩니다. 인증서의 SHA-256 지문은 저장소의 README와 각 릴리스에 있습니다.
업데이트. 새 APK를 기존 앱 위에 설치하면 노트가 그대로 남습니다. 업데이트하려고 제거하지 마세요. 제거하면 Git으로 동기화하지 않았고 Vault 내보내기 (.zip)로 내보내지도 않은 작업 공간이 지워집니다. Obtainium 앱에 저장소 주소를 넣으면 새 버전을 알려 줍니다.

LightNote가 Google Play에 출시되면 한 번 구매하는 유료 앱이 됩니다(가격 미정). 미리 보기에는 스토어 버전의 이용 권한이 포함되지 않으며, 출시 후에는 GitHub의 APK가 더 이상 업데이트되지 않을 수 있습니다.

시작하기: 휴대폰의 Vault

앱은 작업 공간을 보관합니다. 각각 기기 안의 전용 폴더이며, Git 저장소가 있을 수도 없을 수도 있습니다. 홈 화면 위쪽의 작업 공간 이름을 누르면 작업 공간을 바꾸거나 다른 작업 공간을 가져올 수 있습니다.

Git 계정에서 선택 — 액세스 토큰으로 계정(GitHub, GitLab, Gitea/Forgejo 또는 다른 서버)을 추가하면 앱이 그 계정의 저장소를 나열합니다. 하나를 누르면 새 작업 공간으로 복제됩니다. 권장하는 방법이며, 그 뒤로는 변경 사항이 저절로 오갑니다(동기화 참고).
컴퓨터의 QR 코드 스캔 — 컴퓨터의 LightNote에서 Git 메뉴의 휴대폰에서 열기…가 폴더 저장소의 주소와 커밋 작성자가 담긴 QR을 보여 줍니다. 컴퓨터에서 액세스 정보를 포함했다면 앱이 그곳에서 정한 비밀번호를 묻고, 서버에서 토큰을 확인한 뒤 계정을 저장합니다. 비밀번호가 틀리면 다시 입력하면 됩니다. QR을 읽으려면 Google Play 서비스가 필요합니다. 이 서비스가 없는 기기에서는 앱이 알려 주며, 그때는 주소로 복제를 사용하세요.
주소로 복제 — 저장소의 HTTPS 주소를 붙여 넣습니다. 액세스에서 공개 저장소는 아무것도 필요 없고, 비공개 저장소는 액세스 토큰을 붙여 넣습니다(토큰 만들기가 서버 페이지를 엽니다). 사용자는 GitHub도 GitLab도 아닌 서버에서만 묻습니다.
Vault 가져오기 (.zip) — 컴퓨터에서 폴더를 압축해 휴대폰으로 보낸 뒤 폴더 메뉴에서 Vault 가져오기 (.zip)를 선택합니다. 복사본이므로 이후 두 폴더는 연결되지 않습니다. 같은 메뉴의 Vault 내보내기 (.zip)는 반대 방향입니다. 공간 전체를 .zip으로 만들어 보관하거나 컴퓨터로 옮길 수 있습니다.

홈 화면에서는 매일 하는 일로 바로 갑니다. 오늘은 오늘의 노트를 편집 상태로 열고, 빠른 기록은 거기에 한 줄을 추가하며, 바로 아래에 최근 노트와 동기화 상태가 있습니다. 폴더의 파일은 그다음에 나옵니다. 열린 작업이 있으면 보류 중 섹션에 노트의 체크박스와 보드의 작업이 보드 이름과 함께 나열되고, 모두 보기를 누르면 전체 목록이 나옵니다. 동기화, 공간, Git 계정, 카드, 보드 화면에는 도움말 버튼(물음표)이 있어 이 페이지의 해당 섹션을 엽니다.

노트: 읽기와 편집

노트를 누르면 읽기로 열립니다. 제목, 목록, 표, 인용, 콜아웃, LaTeX 수식, Mermaid 다이어그램, 화학 구조식이 컴퓨터와 같은 엔진으로 그려집니다. 노트 사이의 링크([[노트]], [[노트#섹션]])는 앱 안에서 노트를 열고, 웹 링크는 브라우저로 갑니다.

위쪽의 편집 버튼을 누르면 노트의 Markdown 텍스트로 바뀌며, 마크업은 색으로 표시됩니다. 키보드 위 막대에는 실행 취소와 다시 실행, 제목, 굵게, 기울임꼴, 목록, 작업 체크박스, [[ ]] 링크, 코드가 있습니다. 저장은 자동입니다. 입력을 멈추고 잠시 뒤에 저장되며, 뒤로 갈 때, 기기를 회전할 때, 앱을 떠날 때도 저장됩니다.

모든 폴더의 오른쪽 아래에 있는 + 버튼은 그 폴더에 새 노트를 만들고, 키보드가 본문에 놓인 상태로 편집기를 엽니다. 맨 위에는 노트 이름이 있으며, 처음 쓴 줄에서 제안됩니다(그 전에는 날짜와 시각). 탭하면 다른 이름으로 바꿀 수 있습니다. 파일은 본문이 있을 때만 만들어지고, 비어 있는 노트는 폴더에 남지 않습니다. 같은 칸에서 기존 노트의 이름도 바꿀 수 있습니다.

템플릿으로 새 노트(⋮ 메뉴)는 Vault의 Templates(또는 Modelos) 폴더에 있는 템플릿을 사용합니다. 컴퓨터와 같은 템플릿이며 {{title}}과 {{date}} 필드가 채워집니다.

파일이나 폴더를 길게 누르면 이름 바꾸기, 이동, 삭제를 할 수 있고, 새 폴더는 폴더 메뉴에 있습니다. 작업 보드나 표의 이름을 바꾸면 첨부 파일 폴더도 함께 옮겨집니다. 뒤로 버튼은 이전 화면으로 돌아갑니다. 검색에서 연 노트라면 검색으로 돌아갑니다.

목록과 작업. 편집기에서 작업 체크박스는 상자로 그려지며 탭하면 바뀝니다. 완료한 작업에는 취소선이 그어지고, Markdown 기호(#, **, [[ ]])는 커서가 없는 줄에서는 사라져 서식이 적용된 모습으로 보이고, 커서가 그 줄에 들어오면 흐리게 다시 나타납니다. 굵게 버튼(기울임꼴과 코드 버튼도)은 서식 편집기처럼 켜고 끕니다. Enter를 누르면 목록이 이어지고(글머리 기호, 열린 상태로 시작하는 작업, 하나씩 늘어나는 번호), 빈 항목에서 Enter를 누르면 목록에서 나옵니다. 막대에는 번호 목록, 들여쓰기, 내어쓰기가 있어 항목을 하위 목록이 되는 올바른 열로 옮깁니다. 파일은 작성한 Markdown 그대로입니다.

기록하기: 오늘의 노트, 공유, 위젯

오늘은 컴퓨터와 같은 데일리 노트를 엽니다.
빠른 기록은 노트를 열지 않고 오늘의 노트에 시각이 붙은 한 줄을 덧붙입니다.
다른 앱에서 공유하고 LightNote를 고르면, 링크나 짧은 문장은 오늘의 노트의 한 줄이 됩니다(예를 들어 Gemini는 대화를 링크로 공유합니다). 여러 줄의 텍스트(AI의 답변, 기사 발췌 등)는 본문을 그대로 둔 새 노트가 되고, 오늘의 노트에는 그 노트로 가는 링크가 추가됩니다. 사진과 PDF는 하나든 여러 개든 오늘의 노트 첨부 폴더로 들어가고, 노트에 링크가 추가됩니다. 그다음 받은 노트가 화면에 열립니다.
홈 화면 위젯에는 오늘의 노트 열기와 빠른 기록, 두 가지 바로 가기가 있습니다.

음성 메모. 홈 화면의 음성 메모 버튼(또는 아이콘 바로가기)으로 마이크 녹음을 합니다. 화면이 꺼져 있어도 녹음은 계속되며, 알림에 경과 시간과 중지가 표시됩니다. 녹음은 작업 공간의 녹음 폴더(녹음, 컴퓨터의 LightNote와 같은 폴더)에 저장되고 오늘의 노트에 한 줄로 추가되며, 누르면 플레이어가 열립니다. 파일은 컴퓨터가 녹음하고 전사할 수 있는 .m4a 형식이며, 전사와 요약은 동기화한 뒤 컴퓨터에서 합니다.

검색과 연결된 노트

검색은 Vault의 모든 노트 본문을 찾아, 일치하는 곳마다 노트와 줄 번호를 보여 줍니다. 결과를 누르면 노트가 열립니다. 각 노트 아래의 이 노트를 가리키는 노트에는 그 노트로 링크한 노트가 나열됩니다.

작업, 표, 베이스

작업 보드(.lnt)는 상태별 열로 열립니다. 작업을 다른 열로 옮기고, 체크리스트 항목을 체크하고, 이름을 바꾸고, 작업을 만들 수 있습니다. 휴대폰이 보여 주지 않는 필드도 파일에 그대로 남습니다. 작업을 누르면 제목, 마감일, 우선순위, 열 같은 항목이 열리고, 거기서 바로 보관하거나 삭제할 수 있습니다.
사용자 지정 표(.lnd)는 컴퓨터의 열 그대로 열립니다. 텍스트, 숫자, 체크박스, 선택 셀을 편집하고 행을 추가할 수 있습니다. 비밀번호 열은 ****로 표시됩니다. 셀을 누르면 암호 문구를 묻고, 표시를 누르면 비밀번호가 보이며 복사는 그것을 클립보드에 넣습니다. 클립보드는 30초 뒤에 비워집니다.
베이스(.lnq)는 쿼리 결과를 읽기 전용으로 보여 줍니다.
작업이나 행의 파일 폴더는 레코드에 표시되며, 첨부 파일은 거기서 엽니다.

LightNote의 더 새로운 버전이 저장한 보드나 표는 열지 않습니다. 파일을 망가뜨릴 위험을 지는 대신 앱이 그렇다고 알려 줍니다. 앱을 업데이트하세요.

복습 카드

카드 복습은 #flashcards(또는 #cartoes) 태그가 붙은 노트에서 오늘이 기한인 카드를 가져옵니다. 문법은 컴퓨터와 같습니다. 정답 보기를 누를 때까지 답은 숨겨지고, 네 가지 평가(다시, 어려움, 보통, 쉬움)에는 각각 다음 간격이 표시됩니다. 일정은 답할 때마다 저장되며 컴퓨터와 동기화됩니다.

알림

오늘이 기한이거나 이미 기한이 지난 작업은 앱을 열 때 알림을 보내고, 며칠 뒤의 작업은 기한 당일 오전 9시로 예약됩니다. Android 13 이상에서는 알릴 것이 있을 때에만 알림 권한을 요청합니다.

기타 파일

코드는 컴퓨터 편집기와 같은 색으로 열립니다. 위쪽의 연필을 누르면 일반 텍스트 편집(노트 서식 없음)으로 바뀌며, 1 MB 이하의 파일에서 쓸 수 있습니다. 파일의 인코딩과 줄 끝은 그대로 유지됩니다.
블록 노트북(.lnb)은 한 페이지로 열리며, 셀이 노트북 순서대로 나오고 각 셀 아래에 컴퓨터에서 마지막으로 실행한 결과가 표시됩니다. 휴대폰에서는 아무것도 실행하지 않습니다. 셀 이름을 탭하면 그 파일을 편집할 수 있습니다.
데이터베이스 연결(.lnc), HTTP 테스트(.lnh), SSH 연결(.lns)은 컴퓨터의 LightNote가 실행하는 파일입니다. 휴대폰에서는 어떤 파일인지 알려 주는 문장과 함께 읽기 전용으로 열립니다.
이미지는 두 손가락으로 확대할 수 있고, PDF는 한 쪽씩 보여 줍니다.
CSV와 TSV는 표로 열리며(큰 파일은 앞쪽 행만), 구분자는 자동으로 알아냅니다.
그 밖의 형식은 다른 앱으로 열기로 넘어가, 그 파일을 열 수 있는 기기의 앱을 보여 줍니다.

보안 Markdown

암호화된 노트(.lne)는 작업 공간의 암호 문구를 요구합니다. 암호 문구는 앱이 열려 있는 동안에만 메모리에 있고, 평문은 디스크에 절대 쓰이지 않습니다. 노트는 컴퓨터와 같은 코드로 복호화되었다가 다시 암호화됩니다.

컴퓨터와 동기화 (Git)

동기화는 Git 저장소(GitHub, GitLab, Gitea…)를 사용하며, 컴퓨터의 LightNote가 그 폴더에서 쓰는 것과 같습니다. 복제한 각 작업 공간은 해당 서버의 Git 계정으로 자신의 저장소와 동기화됩니다.

Git 계정. Git 계정에서 제공자와 서버를 고르고, 휴대폰에서 쓸 저장소에 읽기·쓰기 권한이 있는 액세스 토큰을 붙여 넣습니다(GitHub에서는 개인 액세스 토큰이며, 사이트에서 토큰 만들기 버튼이 해당 페이지를 엽니다). 앱은 토큰을 확인한 뒤 기기에 암호화해 저장합니다. 기타 서버(기타 서버)는 사용자도 입력해야 하며 저장소 목록이 없으므로, 주소로 복제합니다.

복제한 뒤에는 동기화가 저절로 실행됩니다. 앱을 열 때, 저장하는 화면(노트, 보드, 작업, 표, 카드)을 떠날 때, 앱이 백그라운드로 갈 때입니다. 노트가 열려 있는 동안에는 받은 내용 중 그 노트를 바꿀 것이 노트를 닫을 때까지 기다립니다. 그렇지 않으면 편집기가 자기 텍스트로 덮어쓰기 때문입니다. 홈 화면에는 마지막 동기화 시각, 보낼 변경 사항, 실패 여부가 표시되며, 동기화(받기 및 보내기)로 같은 작업을 바로 할 수 있습니다. 네트워크 오류는 조용히 넘어가고 다음 번에 다시 시도합니다.

커밋 작성자. 휴대폰의 커밋에는 이름과 이메일이 들어갑니다. QR로 가져온 작업 공간이면 컴퓨터의 것을, 아니면 Git 계정의 것을 씁니다(GitHub에서는 프로필의 noreply 이메일로, 커밋이 프로필에 연결됩니다). 동기화 (Git)에서 작성자 옆의 편집으로 둘 다 바꿀 수 있습니다.

충돌. 같은 노트가 휴대폰과 컴퓨터에서 모두 바뀌었을 때, 서로 다른 부분의 변경은 합쳐집니다. 같은 부분이었다면 아무것도 잃지 않습니다. 휴대폰의 버전이 옆에 복사본(노트 (휴대폰).md)으로 남고, 앱이 만든 복사본을 알려 줍니다. 작업 보드, 표, 카드는 레코드 단위로 합쳐집니다.

휴대폰은 Git LFS와 서브모듈을 지원하지 않습니다. LFS 파일은 작은 텍스트 포인터로 도착하며(휴대폰에서 편집하지 마세요), 서브모듈은 빈 폴더로 보입니다. 저장소가 둘 중 하나를 쓰면 화면에 경고가 나옵니다.

충돌 사본은 확인할 때까지 동기화 (Git)에 목록으로 남아 있으며, 누르면 열립니다. 작업 공간 목록에서 휴대폰에서 제거를 누르면 이 휴대폰에서 그 폴더가 삭제됩니다. 이미 동기화된 내용은 저장소에 남습니다. 현재 작업 공간이면 앱이 먼저 다른 작업 공간으로 전환하며, 작업 공간이 하나뿐이면 제거할 수 없습니다. 아직 올라가지 않은 내용이 있으면 사라질 변경 사항의 수를 알려 주고 동기화 후 제거를 제안합니다.

컴퓨터에만 있는 기능

휴대폰은 읽고, 쓰고, 기록하는 용도입니다. 다음 기능은 컴퓨터에만 있습니다: AI 어시스턴트와 MCP, SQL 클라이언트와 데이터 분석, 터미널, Word·PDF 등으로 내보내기, 다른 앱에서 가져오기, 버전 기록, 일정 포함 모드에서 보드 편집. Office 문서와 EPUB은 다른 앱으로 열기로 엽니다.