SiYuan이란 무엇인가?
SiYuan은 셀프 호스팅되는 블록 기반 개인 지식 관리 애플리케이션입니다 — 기본 단위가 페이지가 아니라 개별 블록(문단, 제목, 목록 항목, 코드 블록, 표 셀)인 노트 시스템입니다. 공식 사이트는 이를 "세밀한 블록 단위 참조와 Markdown WYSIWYG를 지원하는 프라이버시 우선 개인 지식 관리 시스템"으로 설명합니다. 모든 블록이 고유한 식별자를 가지므로, 문서 전체가 아니라 노트 어디에서든 특정 블록을 참조·임베드·링크할 수 있습니다.
- 핵심 기능: 기본적으로 콘텐츠를 로컬에 저장하며 선택적으로 셀프 호스팅 또는 유료 클라우드 동기화를 지원하는 블록 기반 에디터 및 지식 베이스
- 편집 모델: 20종 이상의 블록 단위 요소와 10종 이상의 인라인 요소를 지원하는 Markdown WYSIWYG, 수식, 순서도, 웹 클리핑 포함
- 링크 모델: 블록 간 양방향 링크, 백링크 패널, 인터랙티브 그래프 뷰
- 데이터베이스 뷰: 노트 안에서 구조화된 데이터를 위한 롤업 필드가 있는 표 형태의 데이터베이스 블록
- AI 통합: 사용자가 설정한 LLM 제공업체와 연결되는 작성 보조 및 Q&A 채팅(SiYuan 문서는 OpenAI 호환 API 지원을 명시)
- 개발사: Solo 블로그 엔진, Vditor 에디터 등 다른 오픈소스 도구도 유지 관리하는 조직 B3log(Yunnan Liandi Technology Co., Ltd.)
- 표준 저장소: github.com/siyuan-note/siyuan
SiYuan의 프로젝트 히스토리와 버전 마일스톤
SiYuan은 2010년대 중반부터 여러 개발자·콘텐츠 도구를 유지해 온 중국 기반 오픈소스 그룹 B3log가 개발했습니다. 이 프로젝트는 GitHub에서 꾸준히 릴리스되어 왔으며, GitHub Releases 페이지에서 볼 수 있는 릴리스 히스토리는 현재 안정 버전 계열만 해도 수십 개의 알파, 베타, 정식 빌드를 기록하고 있습니다.
SiYuan으로 무엇을 할 수 있나?
SiYuan의 기능은 블록 단위 노트 정리를 중심으로 하며, 그 위에 AI, 데이터베이스, 간격 반복 학습 기능이 더해져 있습니다. 각 기능이 실제로 무엇을 하는지 SiYuan 공식 문서와 GitHub README를 기준으로 정리했습니다.
- 블록 기반 편집 — 모든 문단, 제목, 목록 항목, 표 셀은 개별적으로 주소를 가진 블록으로, 문서의 나머지 부분과 독립적으로 참조·임베드·이동 가능
- 양방향 링크와 그래프 뷰 — 블록끼리 서로 링크하고, 백링크 패널에서 들어오는 링크를 확인하며, 인터랙티브 그래프에서 전체 지식 베이스의 연결을 시각화
- 데이터베이스 블록 — 노트 안에 표 형태의 데이터베이스를 구축하고, 연결된 블록의 데이터를 집계하는 롤업 필드 활용
- 간격 반복 학습 — 능동적 암기를 위한 FSRS(Free Spaced Repetition Scheduler) 알고리즘 기반의 내장 플래시카드 시스템
- AI 작성 보조 및 Q&A 채팅 — LLM 제공업체(셀프 호스팅 백엔드를 포함한 OpenAI 호환 API)를 연결해 초안 작성을 돕거나 노트 내용을 바탕으로 질문
- 플러그인 생태계 — 커뮤니티 및 공식 플러그인, 그리고 맞춤 스타일링과 동작을 위한 JavaScript/CSS 스니펫으로 SiYuan 확장
- 대용량 문서 처리 — SiYuan 문서에 따르면 전체 노트를 한 번에 메모리에 불러오는 대신 동적 로딩을 통해 매우 큰 문서를 지원
- 다중 기기 사용 — Docker를 통한 셀프 호스팅 가능한 서버/웹 모드로 브라우저에서 노트에 접근하거나 SiYuan을 개인 서버로 운영할 수 있으며, 이는 유료 공식 클라우드 동기화와는 별개
사용 예시: SiYuan을 활용하는 세 가지 방법
아래는 SiYuan의 문서화된 기능을 기반으로 한 구체적인 워크플로우이며, 가상의 사용 사례가 아닙니다.
완전히 오프라인으로 개인 지식 베이스 구축하기
데스크톱에 SiYuan을 설치하고 노트북을 만든 뒤 블록 에디터로 작성을 시작하세요. 작성하면서 관련 블록끼리 서로 링크하고, 나중에 백링크 패널로 연결 관계를 다시 발견할 수 있습니다. 모든 것은 기본적으로 로컬에 저장되며, 앱을 설치한 후에는 계정이나 인터넷 연결이 필요하지 않습니다.
노트를 간격 반복용 플래시카드로 전환하기
암기하고 싶은 블록을 선택해 플래시카드 덱에 추가하세요. SiYuan의 내장 FSRS 기반 간격 반복 시스템이 복습 일정을 자동으로 잡아 주는데, 이는 Anki 같은 전용 플래시카드 앱과 동일한 방식이면서도 이미 노트에 있는 블록에 직접 적용됩니다.
AI 제공업체를 연결해 노트에 대해 질문하기
설정에서 OpenAI 호환 API 엔드포인트와 키를 추가하세요 — 클라우드 제공업체일 수도, Ollama 같은 셀프 호스팅 백엔드일 수도 있습니다. 설정을 마치면 SiYuan의 AI 채팅으로 자신의 노트 내용을 바탕으로 질문하거나 작성 도움을 받을 수 있으며, SiYuan이 노트를 기기 밖에 저장하는 일은 없습니다.
데스크톱 및 모바일용 SiYuan 다운로드
SiYuan은 Windows, macOS, Linux, Android, iOS, HarmonyOS에서 이용할 수 있습니다. 아래 링크는 공식 다운로드 페이지와 GitHub 릴리스에서 가져왔습니다 — 빌드 URL과 버전 번호는 릴리스마다 바뀌므로 항상 해당 페이지에서 직접 확인하세요.
플랫폼 | 다운로드 |
|---|---|
| Windows | 설치 파일(x86_64) 또는 Microsoft Store |
| macOS(Apple Silicon) | siyuan-3.8.4-mac-arm64.dmg |
| macOS(Intel) | siyuan-3.8.4-mac.dmg |
| Linux | AppImage, .deb, 또는 .rpm(x86_64 및 ARM64) |
| Android | APK 직접 다운로드 또는 Google Play |
| iOS | App Store |
SiYuan은 서버/웹 인스턴스를 셀프 호스팅할 수 있는 공식 Docker 이미지도 제공하며, 이를 통해 홈 서버나 VPS에서 SiYuan을 운영하고 어떤 브라우저에서든 노트에 접근할 수 있습니다 — 유료 공식 클라우드 동기화의 셀프 호스팅 대안입니다. 모바일에서의 실제 사용성은 기기에 따라 다르며, 지원되는 OS를 구동하는 것 외에 공개된 최소 하드웨어 요구 사항은 없습니다.
SiYuan 가격: SiYuan은 정말 무료인가?
네, 로컬 사용에 한해서는 그렇습니다 — 핵심 앱은 영구 무료이며 블록 편집, 링크, 플러그인, 로컬 AI 연결 등에 어떤 기능 제한도 없습니다. SiYuan의 유료 등급은 b3log.org/siyuan/en/pricing.html에 따르면 오직 공식 클라우드 서비스를 위한 것입니다.
무료
- 가격:
- $0
- 추가되는 기능:
- 전체 로컬 앱: 블록 편집, 링크, 데이터베이스 블록, 플러그인, 간격 반복, 직접 설정한 AI 연결 — 기간 제한 없음
PRO
- 가격:
- $64 일회성(정가 $96)
- 추가되는 기능:
- Amazon S3, WebDAV를 포함한 서드파티 동기화/백업 연동
구독
- 가격:
- $148 일회성/평생(정가 $296)
- 추가되는 기능:
- PRO의 모든 기능에 더해 8GB 저장 공간을 제공하는 공식 종단간 암호화 클라우드 동기화, 클라우드 수신함, 자동 백업
위 가격은 이 리뷰 작성 시점에 SiYuan 공식 가격 페이지에 게시된 평생/일회성 금액을 반영한 것입니다 — 가격과 프로모션 할인은 변경될 수 있으므로 b3log.org/siyuan/en/pricing.html에서 현재 가격을 직접 확인하세요. 직접 선택한 AI 제공업체(OpenAI, 셀프 호스팅 모델 등)를 사용할 경우 요금은 SiYuan이 아니라 해당 제공업체가 별도로 청구합니다.
SiYuan vs. Obsidian
SiYuan과 Obsidian은 둘 다 로컬 우선, Markdown 기반 지식 관리 앱으로 자주 비교됩니다. 두 앱 모두 노트 파일의 완전한 소유권을 유지할 수 있고 활발한 플러그인 생태계를 갖추고 있기 때문입니다. 가장 분명한 차이는 기본 데이터 모델과 라이선스에 있습니다.
핵심 단위
- SiYuan:
- 블록(문단, 제목, 목록 항목 등)
- Obsidian:
- 파일(노트당 하나의 Markdown 파일)
저장 형식
- SiYuan:
- 블록을 참조하는 내부 데이터베이스; Markdown으로 내보내기 가능
- Obsidian:
- 기본적으로 일반 로컬 Markdown 파일
라이선스
- SiYuan:
- AGPL-3.0, 완전한 오픈소스
- Obsidian:
- 무료 사용 가능; 소스 비공개
내장 AI 기능
- SiYuan:
- 있음 — 설정 가능한 제공업체를 통한 작성 보조 및 Q&A 채팅
- Obsidian:
- 내장되어 있지 않음; 커뮤니티 플러그인으로 이용 가능
클라우드 동기화
- SiYuan:
- 선택적 유료 공식 동기화, 또는 Docker/서드파티(PRO의 S3/WebDAV)를 통한 셀프 호스팅
- Obsidian:
- 선택적 유료 공식 Sync 부가 기능, 또는 플러그인을 통한 서드파티/셀프 호스팅 동기화
모바일 앱
- SiYuan:
- Android, iOS, HarmonyOS
- Obsidian:
- Android, iOS
완전한 오픈소스 소프트웨어와 (파일 단위가 아닌) 블록 단위 참조를 우선시한다면 SiYuan의 데이터 모델이 둘 중 더 세밀합니다. 순수 Markdown 파일의 이식성과 가장 큰 기존 플러그인/테마 생태계를 우선시한다면 obsidian.md에서 Obsidian을 직접 살펴볼 가치가 있습니다. PromptQuorum은 현재 Obsidian에 대한 전용 리뷰를 제공하지 않으며, 이 비교는 PromptQuorum이 Obsidian을 별도로 테스트한 결과가 아니라 Obsidian 공식 사이트의 정보를 기반으로 합니다.
SiYuan은 누구에게 적합한가?
SiYuan이 적합한지는 (페이지 단위가 아닌) 블록 단위 링크, 완전한 데이터 소유권, 그리고 하나의 셀프 호스팅 앱 안에서 선택적 AI 기능을 원하는지에 달려 있습니다.
다음의 경우 SiYuan을 사용하세요
- 데이터를 기본적으로 자신의 기기에 완전히 저장하고, 클라우드 동기화는 명시적으로 선택 가능한 유료 부가 기능으로 두고 싶은 경우
- 노트 전체에서 (전체 문서가 아니라) 개별 블록을 참조·임베드·링크하고 싶은 경우
- 노트와 같은 앱 안에서 내장 데이터베이스 블록과 간격 반복 플래시카드 시스템을 원하는 경우
- 필수 구독 없이 자신의 AI 제공업체(클라우드 또는 셀프 호스팅)를 연결해 작성 보조나 노트 기반 Q&A를 이용하고 싶은 경우
- 기반 애플리케이션이 오픈소스(AGPL-3.0)이고 셀프 호스팅 가능하기를 원하며, Docker로 직접 동기화 서버를 운영하고 싶은 경우
다음의 경우 잠시 보류하거나 다른 곳을 찾아보세요
- 원본 노트를 기본적으로 디스크에 일반적인 이식 가능한 Markdown 파일로 저장하고 싶은 경우 — SiYuan은 내부 블록 기반 데이터베이스를 사용하며 Markdown은 네이티브 저장 형식이 아니라 가져오기/내보내기 형식으로 제공됩니다
- 가능한 한 가장 큰 서드파티 플러그인·테마 생태계가 필요한 경우 — Obsidian과 Logseq 모두 더 크고 오래된 플러그인 커뮤니티를 보유하고 있습니다
- 유료 등급 없이 완전 무료인 공식 클라우드 동기화를 원하는 경우 — SiYuan의 공식 동기화 서비스는 PRO/구독 가격의 일부입니다
- SLA가 포함된 공식 엔터프라이즈 지원이 필요한 경우 — SiYuan의 지원 채널은 GitHub Issues와 커뮤니티 포럼으로, 상업 벤더가 아닌 오픈소스 프로젝트에 전형적인 형태입니다
SiYuan vs. 다른 지식 관리 도구
SiYuan은 로컬 우선의 블록 또는 파일 기반 지식 관리 앱이라는 작은 분야에 속해 있습니다. PromptQuorum은 아직 Obsidian이나 Logseq 자체를 독립 앱으로 다루는 전용 FeatureAppPost 리뷰를 제공하지 않으며, 이 하위 분야에서 가장 가까운 기존 리뷰들을 아래에 정리하고 가장 관련성 높은 두 개의 외부 비교도 함께 소개합니다. 전체 카탈로그는 로컬 LLM 소프트웨어 디렉터리를 참고하세요.
- Khoj — 자신의 노트와 문서를 인덱싱하고 대화할 수 있는 셀프 호스팅 오픈소스 "세컨드 브레인" AI 어시스턴트로, 개인 지식 어시스턴트 분야에서 PromptQuorum에 존재하는 가장 가까운 리뷰입니다. Khoj AI 리뷰를 참고하세요.
- Logseq Copilot — SiYuan 같은 독립형 지식 베이스 앱이 아니라, 오픈소스 아웃라이너 앱 Logseq를 위한 AI 브라우저 확장/플러그인 부가 기능이지만, 블록 기반 로컬 우선 노트 작성을 다루는 PromptQuorum의 가장 가까운 기존 리뷰입니다. Logseq Copilot 리뷰를 참고하세요.
- Obsidian — 소스는 비공개지만 널리 사용되는 로컬 Markdown 파일 노트 앱으로, 매우 큰 플러그인/테마 생태계를 갖추고 있습니다. 위의 전용 비교 섹션을 참고하세요(아직 PromptQuorum의 별도 Obsidian 리뷰는 없습니다).
- Logseq — Obsidian의 파일 기반 모델보다 개념적으로 SiYuan에 더 가까운, 블록 기반의 양방향 링크 구조를 가진 오픈소스 로컬 우선 아웃라이너입니다. PromptQuorum이 아직 독립적인 Logseq 앱 리뷰를 제공하지 않으므로 logseq.com에서 직접 확인하세요.
SiYuan 평가 시 흔한 실수
SiYuan에 대한 혼란은 대부분 Obsidian처럼 일반 Markdown 파일을 저장한다고 가정하거나, 유료 등급이 실제로 무엇을 제한하는지 오해하거나, AI 기능에 특정 유료 제공업체가 필요하다고 가정하는 데서 비롯됩니다.
실수 1: SiYuan이 디스크에 일반 Markdown 파일을 저장한다고 가정
Obsidian과 달리 SiYuan의 네이티브 저장 방식은 일반 .md 파일 폴더가 아니라 내부 블록 기반 데이터베이스입니다. Markdown 가져오기/내보내기는 지원되지만 네이티브 형식은 블록 지향입니다 — SiYuan 밖에서 파일 단위 이식성이 반드시 필요하다면 이 점을 확인하세요.
실수 2: SiYuan을 사용하려면 무조건 유료 등급이 필요하다고 가정
무료 등급은 기간 제한이 없으며 핵심 노트 작성, 블록 링크, 플러그인, 데이터베이스 블록, 간격 반복 등에 어떤 기능 제한도 없습니다. 유료 PRO 및 구독 등급은 공식 클라우드 동기화, 서드파티 동기화 대상(S3/WebDAV), 클라우드 수신함만 추가합니다.
실수 3: SiYuan의 AI 기능에 특정 유료 AI 구독이 필요하다고 가정
SiYuan의 AI 기능은 사용자가 설정한 OpenAI 호환 제공업체 어디에든 연결됩니다 — 유료 클라우드 API일 수도 있고, Ollama 같은 무료 셀프 호스팅 백엔드일 수도 있습니다. SiYuan 자체는 특정 유료 AI 플랜을 번들로 제공하거나 요구하지 않습니다.
실수 4: "로컬 우선"을 "클라우드 옵션이 전혀 없음"과 혼동
SiYuan은 로컬 우선이지 로컬 전용이 아닙니다. 공식 유료 클라우드 동기화 서비스를 제공하며 S3/WebDAV 같은 서드파티 대상으로도 동기화할 수 있습니다(PRO 등급) — 이 중 하나를 켜지 않는 한 데이터가 기기 밖으로 나갈 필요는 없을 뿐입니다.
자주 묻는 질문
SiYuan이란 무엇인가요?
SiYuan(b3log.org/siyuan, 소스는 github.com/siyuan-note/siyuan)은 양방향 링크가 가능한 블록 단위 에디터를 중심으로 구축된 무료 오픈소스 셀프 호스팅 지식 관리 앱으로, B3log 조직이 개발했습니다.
SiYuan은 무료인가요?
네, 핵심 앱은 로컬 사용에 어떤 기능 제한도 없이 영구 무료입니다. 유료 PRO($64 일회성)와 구독($148 일회성/평생) 등급은 공식 클라우드 동기화, 서드파티 동기화(S3/WebDAV), 클라우드 수신함만 추가합니다 — 현재 가격은 SiYuan 가격 페이지를 참고하세요.
SiYuan은 오픈소스인가요? 어떤 라이선스를 사용하나요?
네. SiYuan은 GitHub 저장소의 LICENSE 파일에 따라 AGPL-3.0 라이선스를 사용합니다.
SiYuan은 노트를 로컬에 저장하나요?
네, 기본적으로 그렇습니다. 공식 클라우드 동기화 서비스를 명시적으로 활성화하거나 서드파티 동기화 대상을 설정하지 않는 한 노트와 블록은 사용자 기기에 완전히 저장됩니다.
SiYuan은 Obsidian처럼 작동하나요?
둘 다 로컬 우선이고 Markdown 친화적인 지식 관리 앱이지만, 핵심 데이터 모델은 다릅니다. SiYuan의 네이티브 단위는 블록(내부 데이터베이스 사용)이고, Obsidian은 각 노트를 일반 Markdown 파일로 저장합니다. 위의 SiYuan vs. Obsidian 전용 섹션을 참고하세요.
SiYuan에는 AI 기능이 있나요?
네. SiYuan에는 OpenAI 호환 API를 통해 사용자가 설정한 LLM 제공업체와 연결되는 AI 작성 보조 및 Q&A 채팅이 포함되어 있으며, 유료 클라우드 제공업체뿐 아니라 Ollama 같은 셀프 호스팅 백엔드도 포함됩니다.
SiYuan은 어떤 플랫폼을 지원하나요?
공식 다운로드 페이지에 따르면 Windows, macOS, Linux, Android, iOS, HarmonyOS를 지원하며, 셀프 호스팅 가능한 Docker 기반 서버/웹 모드도 제공합니다.
공식 클라우드 비용을 내는 대신 SiYuan 동기화를 셀프 호스팅할 수 있나요?
네. SiYuan의 PRO 등급은 Amazon S3나 WebDAV 서버 같은 자체 서드파티 스토리지로의 동기화를 지원하며, 공식 Docker 이미지로 셀프 호스팅 서버/웹 인스턴스도 운영할 수 있습니다.
SiYuan은 누가 개발하나요?
SiYuan은 Solo 블로그 엔진 등 다른 오픈소스 도구도 유지 관리하는 조직인 B3log(Yunnan Liandi Technology Co., Ltd.)가 개발합니다.
SiYuan의 최신 버전은 무엇인가요?
이 리뷰 작성 시점 기준 최신 안정 버전은 3.8.4(2026년 9월 17일)입니다 — 이 리뷰의 게시일 이후 출시된 내용은 공식 GitHub 릴리스 페이지에서 확인하세요.
SiYuan은 간격 반복/플래시카드를 지원하나요?
네. SiYuan에는 FSRS(Free Spaced Repetition Scheduler) 알고리즘 기반의 내장 플래시카드 시스템이 있어, 노트에 있는 블록을 복습용 카드로 전환할 수 있습니다.