소개
znote는 개발자를 위해 설계된 로컬 우선(local-first) 마크다운 노트 앱입니다. 이 앱은 일반 .md 파일을 사용하며, AI 및 코드 실행 기능을 통합하여 노트를 단순한 기록 이상의 도구로 활용할 수 있게 합니다. Windows, macOS, Linux를 지원하며, 무료로 제공됩니다.
상세정보
WYSIWYG 마크다운 편집
마크다운을 입력하는 대로 렌더링하여 보여주는 위지위그(WYSIWYG) 편집기를 제공합니다. 다크, Nord, Orange, Terminal 등 다양한 테마를 지원하며, 탭, 태그, 전체 텍스트 검색 기능을 갖추고 있습니다.
AI 통합
에디터 안에서 @를 입력하여 노트, 폴더, 코드 블록을 컨텍스트로 참조할 수 있습니다. AI가 사용자의 파일을 읽고 결과를 인라인으로 작성해 줍니다. OpenAI, Ollama(로컬), OpenRouter 등 다양한 AI 제공자를 지원하며, API 키를 직접 사용합니다.
코드 블록 실행
JavaScript/Node.js 코드 블록을 노트 안에서 로컬로 실행할 수 있습니다. 데이터베이스 쿼리, API 호출, 데이터 처리 등을 수행하고 결과를 차트나 테이블로 인라인 렌더링할 수 있습니다.
MCP 서버 지원
Model Context Protocol(MCP)을 통해 GitHub, Postgres, Slack, Linear 등 다양한 도구를 AI 블록에 연결할 수 있습니다. 서버는 로컬에서 실행됩니다.
Obsidian 호환
일반 .md 파일을 사용하므로 기존 Obsidian 볼트를 그대로 열 수 있으며, 위키링크, 임베드, 첨부 파일 등이 지원됩니다. Obsidian용 컴패니언 플러그인을 통해 ‘Run in Znote’ 버튼을 추가할 수도 있습니다.
설치 및 시작
znote는 공식 웹사이트(znote.io)에서 다운로드할 수 있습니다. Windows에서는 .exe 설치 프로그램을 실행하고, macOS에서는 .dmg를 열어 Applications 폴더로 드래그합니다. Linux에서는 .AppImage를 실행합니다. 계정 생성 없이 오프라인으로 사용할 수 있습니다.
Windows에서는 winget을 통해서도 설치할 수 있습니다. 명령 프롬프트나 PowerShell에서 다음 명령을 실행합니다.
winget install --id alagrede.znote --exact첫 실행 시 AI 기능을 위한 API 키 설정을 안내합니다. API 키가 없으면 무료 체험 요청을 사용할 수 있습니다.
활용 예시
- 주간 보고서 작성: @references로 관련 노트를 참조하여 AI가 요약을 작성하게 할 수 있습니다.
- 데이터 분석: 코드 블록에서 데이터베이스를 쿼리하고 결과를 차트로 렌더링할 수 있습니다.
- API 테스트: 코드 블록에서 API를 호출하고 응답을 확인할 수 있습니다.
- Obsidian 볼트와 함께 사용: 기존 볼트를 열고 AI 및 코드 실행 기능을 추가로 활용할 수 있습니다.
지원 환경
Windows(x64 및 arm64), macOS(Intel 및 Apple Silicon), Linux(x64 및 arm64)를 지원합니다. Windows에서는 winget 패키지로도 배포됩니다.
버전 및 업데이트
현재 버전은 4.8.0이며, Git 통합 기능이 개선되었습니다. 사이드바에서 Git 저장소를 관리할 수 있으며, 풀/푸시, 변경 사항 표시, 충돌 처리 등을 지원합니다.
라이선스 및 확인 사항
znote는 프리웨어(Freeware)로 제공됩니다. 모든 기능이 포함되어 있으며, AI 기능 사용 시 API 키가 필요할 수 있습니다. 로컬 우선 방식으로 오프라인에서도 사용할 수 있으며, 기본적으로 원격 분석(telemetry)을 수집하지 않습니다.
시스템 요구사항
Windows 11 · x64 · winget


