[Logseq] 문서 대신 불릿으로 쓰는 로컬 노트

개발자 도구 · 노트 & 지식관리

[Logseq] 문서 대신 불릿으로 쓰는 로컬 노트

Logseq는 "문서를 만들고 폴더에 정리하는" 기존 노트 앱의 자리를 아웃라이너 방식으로 대체하는 오픈소스 도구예요. 모든 메모가 불릿(블록) 하나로 시작하고 데이터는 클라우드가 아니라 내 컴퓨터의 마크다운 파일로 남습니다. 이 글에서는 문서형 노트와 뭐가 다른지, 처음 설치해서 저널·백링크·쿼리까지 쓰는 순서, 그리고 도입 전에 알아야 할 DB 버전 전환기 이슈까지 정리합니다.

문서를 쌓는 게 아니라 블록을 쌓는 노트예요

Notion이나 Obsidian 같은 노트 앱은 기본 단위가 "페이지(문서)"예요. 글 하나를 만들어 제목을 붙인 뒤 어느 폴더에 넣을지 정하는 흐름이죠. Logseq는 기본 단위가 블록(불릿 한 줄)입니다. 페이지를 먼저 만드는 게 아니라, 오늘 날짜 저널에 불릿을 하나 적는 것부터 시작해요.

공식 소개 문구는 "privacy-first, open-source platform for knowledge management"입니다. 여기서 privacy-first가 구호가 아닌 게, 모든 데이터가 서버가 아니라 로컬 디스크의 마크다운(또는 Org-mode) 파일로 저장돼요. 라이선스는 AGPL-3.0 오픈소스입니다. 데스크톱 앱은 무료로 GitHub 릴리즈에서 받아요. 2020년에 공개됐고 모바일 앱과 웹 버전(app.logseq.com)도 있어요.

	Logseq	Obsidian	Notion
기본 단위	블록(불릿)	페이지(문서)	페이지 + 데이터베이스
저장 위치	로컬 파일	로컬 파일	클라우드
파일 포맷	Markdown, Org-mode	Markdown	자체 포맷 (내보내기 지원)
라이선스	오픈소스 (AGPL-3.0)	비공개 소스	비공개 소스

같은 로컬 마크다운 계열인 Obsidian과 갈리는 지점이 바로 이 "블록 vs 문서"예요. 긴 글을 완성해 쌓아두는 쪽이면 문서형이 편합니다. 회의 메모·TIL·읽은 것 기록처럼 짧은 조각이 매일 쏟아지는 쪽이면 아웃라이너가 맞아요. Logseq는 후자를 위한 도구예요.

시작은 저널이에요, 오늘 날짜 페이지에 그냥 씁니다

설치는 GitHub 릴리즈 페이지에서 OS에 맞는 파일을 받으면 됩니다. macOS는 dmg, Windows는 exe, Linux는 AppImage와 설치 스크립트가 제공돼요. 앱을 열면 가장 먼저 "그래프(graph)"를 만들라고 하는데, 그래프는 노트 전체를 담는 로컬 폴더 하나를 뜻합니다. 빈 폴더 하나를 지정하면 끝이에요.

그래프를 열면 바로 보이는 화면이 저널(Journals)입니다. 오늘 날짜 페이지가 자동으로 만들어져 있고, 커서가 첫 불릿에 놓여 있어요. 여기가 Logseq 워크플로우의 출발점입니다. "이 메모를 어디에 저장하지?"를 고민하지 않고 일단 오늘 저널에 적는 것 — 분류는 나중에 링크가 대신해 줍니다.

입력 중에 /를 누르면 명령 메뉴가 떠서 할 일(TODO), 날짜, 코드 블록 같은 요소를 바로 넣어요. Tab으로 들여쓰기, Shift+Tab으로 내어쓰기를 하면 블록이 트리 구조로 쌓입니다. 문서형 에디터의 제목·본문 위계 대신, 들여쓰기 깊이가 곧 구조가 되는 방식이에요.

핵심은 링크예요 — 폴더 없이 노트가 연결됩니다

페이지 링크 [[ ]]

메모 중에 [[Kafka]]처럼 대괄호 두 개로 감싸면 그 이름의 페이지가 자동으로 만들어지면서 링크가 걸립니다. 미리 페이지를 만들 필요가 없어요. 저널에 흩어진 메모들이 [[Kafka]] 링크 하나로 한 주제에 모이는 구조입니다.

링크드 레퍼런스 (Linked References)

페이지 하단에는 그 페이지를 링크한 모든 블록이 자동으로 모여서 보여요. Kafka 페이지에 직접 쓴 내용이 없어도, 여러 날짜의 저널에서 [[Kafka]]를 언급한 메모가 전부 그 아래 나타납니다. 폴더 정리를 안 해도 주제별 모아보기가 되는 이유가 이 기능이에요.

블록 참조 (( ))

페이지 단위가 아니라 블록 하나를 다른 곳에 참조하는 것도 됩니다. 특정 불릿을 다른 페이지에 인용하면 원본이 수정될 때 참조한 쪽에도 같이 반영돼요. 문서형 노트에서 같은 내용을 복사해 여러 문서에 붙여넣던 일을 참조 하나로 대신하는 셈입니다.

메모가 그대로 할 일 목록과 플래시카드가 됩니다

태스크 관리

블록 앞에 TODO 키워드를 붙이면 그 메모가 할 일이 됩니다. 클릭할 때마다 TODO → DOING → DONE으로 상태가 바뀌어요. 별도 투두 앱에 옮겨 적는 게 아니라, 회의 메모 중간의 "이거 확인해야 함" 한 줄이 그 자리에서 태스크가 되는 방식입니다.

쿼리

흩어진 블록을 조건으로 모아 오는 쿼리 기능이 있어요. 예를 들어 "아직 DONE이 아닌 TODO 전부" 같은 조건을 페이지에 심어두면 결과가 실시간으로 갱신됩니다. 라이브 쿼리와 화이트보드는 0.9.1 버전(2023년 3월)부터 전체 사용자에게 공개됐어요.

플래시카드와 PDF 주석

블록에 #card 태그를 붙이면 그 블록이 암기 카드가 되어 내장된 간격 반복(spaced repetition) 방식으로 복습 순서가 돌아옵니다. PDF를 그래프에 넣으면 앱 안에서 열어 하이라이트를 칠 수 있고 그 하이라이트가 블록으로 저장되어 노트에서 참조돼요. 논문이나 기술 문서를 읽으며 발췌하는 용도로 쓰이는 기능입니다.

디스크에는 평범한 마크다운 폴더가 남습니다

Logseq가 만드는 그래프 폴더를 파인더나 터미널에서 열어보면 이런 구조예요. 저널은 날짜별 파일로, 직접 만든 페이지는 pages 폴더에 저장됩니다.

my-graph/
├── journals/
│   ├── 2026_07_17.md
│   └── 2026_07_18.md
├── pages/
│   ├── Kafka.md
│   └── 독서 메모.md
└── logseq/
    └── config.edn   # 그래프별 설정 파일

# journals/2026_07_18.md 내용 예시
- TODO [[Kafka]] 컨슈머 랙 모니터링 문서 읽기
- [[독서 메모]] 3장까지 읽음
	- 핵심은 파티션 단위 순서 보장 #card

이 구조의 의미는 탈출 비용이 없다는 거예요. Logseq를 그만 쓰기로 해도 마크다운 파일은 그대로 남아 다른 에디터로 열립니다. Git으로 버전 관리를 하거나 스크립트로 가공하는 것도 일반 텍스트 파일 다루듯 하면 돼요. 클라우드 노트 서비스가 종료되거나 유료 정책이 바뀔 때의 리스크가 구조적으로 없는 저장 방식입니다.

도입 전에 알아둘 것 — 지금은 DB 버전 전환기예요

• DB 버전 전환기 — 공식 저장소 기준으로 현재 파일 기반 버전과 별개로 "DB 그래프"를 쓰는 데이터베이스 버전이 베타로 진행 중입니다. DB 버전용 새 모바일 앱(iOS 먼저, Android 예정)과 실시간 협업(RTC) 동기화는 알파 단계예요. 지금 시작한다면 안정적인 파일 기반 버전으로 시작하되, 개발의 무게중심이 옮겨가는 시기라는 점은 알고 들어가는 게 좋습니다.
• 공식 Sync는 아직 후원자 대상 베타 — 기기 간 동기화 기능인 Logseq Sync는 스폰서·백커 대상 베타로 운영돼 왔어요. 일반 사용자는 iCloud Drive·Dropbox 같은 파일 동기화나 Git으로 폴더 자체를 맞추는 방식을 씁니다. 다만 파일 동기화 서비스 위에서 여러 기기가 동시에 쓰면 충돌 파일이 생길 여지가 있어요.
• 모든 것이 불릿이라는 호불호 — 아웃라이너 구조상 긴 산문형 문서를 쓰기에는 문서형 에디터보다 불편하다는 평가가 따라다닙니다. 블로그 초안처럼 완결된 글 위주라면 맞지 않을 가능성이 높아요.
• 백업은 본인 몫 — 로컬 저장의 뒷면입니다. 서버 백업이 없으니 Time Machine이든 Git이든 백업 수단을 따로 두어야 해요.

설치 안내 데스크톱 앱은 GitHub 릴리즈에서 무료로 받습니다. 설치 없이 써 보려면 브라우저에서 app.logseq.com으로 로컬 폴더를 연결해 체험하는 방법도 있습니다. 플러그인과 테마는 앱 내 마켓플레이스에서 설치해요.

매일 쏟아지는 짧은 기록이 많은 사람에게 맞습니다

정리하면 Logseq가 맞는 경우는 이렇습니다. 회의 메모·TIL·트러블슈팅 기록처럼 짧은 조각이 매일 생기는 사람, 폴더 분류에 번번이 실패해 본 사람, 그리고 노트 데이터를 특정 서비스에 묶어두고 싶지 않은 사람이에요. 반대로 완결된 긴 문서 위주라면 Obsidian 같은 문서형이, 팀 공유와 데이터베이스가 필요하면 Notion 쪽이 용도에 맞습니다.

시작하는 방법은 단순해요. 빈 폴더로 그래프 하나를 만들고, 일주일 동안 모든 메모를 저널에만 적으면서 주제가 보일 때마다 대괄호로 링크를 걸어 보는 것. 폴더 없이 링크만으로 노트가 정리되는 감각이 맞는지 확인되면, 그때 쿼리·플래시카드 같은 기능을 얹어 가면 됩니다.

Sources

Logseq 공식 사이트 Logseq 공식 문서 Logseq GitHub 저장소 (README·릴리즈) Logseq 공식 블로그

이 글은 공식 사이트·문서·저장소를 근거로 한 객관 정리로, 직접 사용기가 아닙니다. 기능과 정책은 이후 버전에서 달라질 수 있습니다.