ZenNotes/zennotes

어떤 프로젝트인가요?

핵심 기능

• 01독점 데이터베이스 없이 일반 Markdown 파일로 노트를 저장합니다.
• 02키보드 중심 편집을 위한 Vim 모드, 리더 키 조작, 명령 팔레트를 제공합니다.
• 03수식, Mermaid, TikZ 렌더링을 지원하는 편집·분할·미리보기 모드를 제공합니다.
• 04작업, 태그, 전문 검색, 보관함, 휴지통 보기를 기본 제공합니다.
• 05AI 도구와 스크립트를 vault에 연결할 수 있는 MCP 서버와 CLI를 제공합니다.

활용 사례

• Vim 편집 기능이 있는 Markdown 노트를 원하는 키보드 중심 사용자.
• 기존 Obsidian 스타일의 Markdown 파일 폴더를 이전하거나 계속 사용하려는 경우.
• MCP를 통해 AI 코딩 어시스턴트가 개인 노트 vault에 접근하도록 하려는 경우.
• 홈 서버나 LAN에서 셀프 호스팅 노트 앱을 실행하려는 경우.

빠른 시작

1. 1

   Homebrew로 macOS에 설치

   brew install --cask zennotes/tap/zennotes
2. 2

   AUR에서 Arch Linux에 설치

   yay -S zennotes-bin
3. 3

   GitHub Releases 페이지에서 플랫폼에 맞는 설치 프로그램 다운로드

사용 전 알아둘 점

• !셀프 호스팅 웹 모드의 백엔드에는 별도의 Go 서버 저장소인 znserver가 필요합니다.
• !개발 환경을 설정하려면 서버 빌드 경로에 Node.js 22+와 Go 1.22+가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

zennotes은(는) 무엇인가요?

Vim 모션, 다이어그램, MCP 연동을 지원하고 디스크에 일반 파일로 노트를 저장하는 키보드 중심 로컬 Markdown 노트 앱입니다. ZenNotes는 디스크의 vault 폴더에 모든 노트를 일반 `.md` 파일로 저장하는 Markdown 노트 앱으로, 숨겨진 데이터베이스를 사용하지 않습니다. macOS, Windows, Linux용 Electron 데스크톱 앱과 Go 서버를 기반으로 하는 셀프 호스팅 웹 앱으로 제공됩니다.

zennotes은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

zennotes은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

zennotes은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. zennotes의 마지막 커밋은 2026년 10월 23일입니다.

zennotes은(는) 어디에 사용할 수 있나요?

Vim 편집 기능이 있는 Markdown 노트를 원하는 키보드 중심 사용자. 기존 Obsidian 스타일의 Markdown 파일 폴더를 이전하거나 계속 사용하려는 경우. MCP를 통해 AI 코딩 어시스턴트가 개인 노트 vault에 접근하도록 하려는 경우. 홈 서버나 LAN에서 셀프 호스팅 노트 앱을 실행하려는 경우.

zennotes는 어떻게 설치하나요?

Homebrew로 macOS에 설치: brew install --cask zennotes/tap/zennotes AUR에서 Arch Linux에 설치: yay -S zennotes-bin GitHub Releases 페이지에서 플랫폼에 맞는 설치 프로그램 다운로드

zennotes은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ZenNotes/zennotes