lumina-note

소개

Lumina Note는 실시간 미리보기, 양방향 링크 및 AI 어시스턴트를 갖춘 현대적인 Markdown 노트 애플리케이션입니다. Electron 41 기반에 React 18/TypeScript 렌더러와 CodeMirror 기반 마크다운 에디터를 사용합니다.

핵심 기능

• 실시간 미리보기: 입력한 마크다운을 바로 렌더링된 형태로 확인할 수 있습니다.
• 양방향 링크 및 역방향 링크: [[노트명]] 형식으로 링크를 삽입하면 자동으로 연결된 노트 목록이 생성됩니다.
• AI 어시스턴트: 내장된 opencode 서버와 SDK를 통해 AI 기반 도움을 받을 수 있습니다(설정 필요).
• 내용 블록 및 개요 view: 노트를 블록 단위로 관리하고 구조별 개요를 볼 수 있습니다.
• 그래프 뷰 및 생각 지도: 노트 간의 관계를 시각적으로 표현합니다.
• 인용 기능: 다른 노트의 내용을 블록 인용 형태로 가져올 수 있습니다.

지원 환경

Windows에서는 .exe NSIS 설치 프로그램, macOS에서는 .dmg 또는 .zip 파일, Linux x64에서는 AppImage 형태를 제공합니다. 각각의 설치 파일을 다운로드하여 실행하면 사용을 시작할 수 있습니다.

기본 사용법

1. 공식 저장소의 릴리스 페이지에서 최신 버전을 다운로드합니다.
2. 설치 후 프로그램을 실행하고, 노트를 저장할 볼트(vault) 폴더를 선택하거나 새로 만듭니다.
3. 노트 편집 화면에서 마크다운 문법을 입력하면 오른쪽 미리보기 pane에서 실시간으로 결과를 확인할 수 있습니다.
4. 다른 노트와 연결하려면 [[노트명]] 형식으로 입력하면 양방향 링크가 생성되고, 연결된 노트에서는 역방향 링크가 자동으로 표시됩니다.
5. AI 어시스턴트를 사용하려면 저장소의 docs/agent-runtime-setup.md 문서에 따라 opencode 서버를 설정해야 합니다.

주의사항 및 제한점

• AI 어시스턴트 기능은 별도의 opencode 서버 설정이 필요하며, 설정 방법은 제공된 문서를 참조해야 합니다.
• 모바일 컴패니언 앱(iOS/Android)은 별도로 제공되며, 데스크톱 버전과 기능이 완전히 동일하지 않을 수 있습니다.
• 플러그인 생태계를 이용하려면 docs/plugin-ecosystem.md를 참고하여 개발 및 설치 방법을 확인할 수 있습니다.

자주 묻는 질문(FAQ)

• 질문: Lumina Note는 어떤 언어로 제공되나요? 답변: 저장소에 README.ko.md 등을 포함한 다국어 README가 있어 한국어 지원이 가능합니다.
• 질문: 플러그인을 어떻게 설치하거나 만들 수 있나요? 답변: docs/plugin-ecosystem.md에 플러그인 개발 및 설치 방법이 상세히 설명되어 있습니다.