옵시디언의 한계를 해결하는 개발자용 노트 앱, SiYuan(사위안)

BBetter Stack
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00지금까지 제가 찾은 Obsidian과 Notion의 가장 훌륭한 대안일지도 모릅니다.
00:00:05우리 개발자 대부분은 실제로 무언가 필요하기 전까지는 메모가 잘 정리되어 있다고 생각하죠.
00:00:10제 메모는 완전히 엉망진창이지만, 저에게는 나름 정리된 상태입니다.
00:00:14마크다운 파일, 끊긴 링크, 대충 던져놓은 임의의 Notion 페이지들까지 말이죠.
00:00:18우리의 코드는 구조가 있지만, 제 메모는 그렇지 않습니다.
00:00:21이것은 Siyuan(思源, SiYuan)입니다.
00:00:23생각을 코드처럼 리팩토링할 수 있게 해주는 오픈 소스 개인 지식 도구입니다.
00:00:28영구적인 블록 ID, 데이터베이스, 내장 SQL, 그리고 우리가 직접 관리하는
00:00:33로컬 셀프 호스팅 제어 기능을 제공하죠.
00:00:34이제 우리의 메모는 코드와 더 비슷하게 작동합니다.
00:00:36앞으로 몇 분 동안, 왜 이것이 개발자를 위한 최고의 메모 도구가 될 수 있는지
00:00:40보여드리겠습니다.
00:00:42Siyuan은 로컬 우선의 오픈 소스 지식 베이스입니다.
00:00:50대부분의 도구는 파일을 연결하지만, Siyuan은 블록을 연결합니다.
00:00:53그래서 각 단락, 리스트, 코드 블록은 각각 고유한 영구 ID를 갖게 됩니다.
00:00:59이제 내용을 여기저기 옮겨도 링크가 깨지지 않습니다.
00:01:02문서를 작성하거나 버그를 추적하거나 아키텍처를 정리할 때 이건 아주 중요한 장점이죠.
00:01:06게다가 내장 데이터베이스, SQL 쿼리, 오프라인 지원, Docker 셀프 호스팅까지 지원합니다.
00:01:13강력한 기능과 데이터 소유권 사이에서 고민할 필요 없이, 이 도구로 두 마리 토끼를 다 잡을 수 있습니다.
00:01:18실제로 어떻게 작동하는지 보여드리겠습니다.
00:01:20오픈 소스 도구와 코딩 팁을 즐기신다면, Better Stack 채널을
00:01:24구독해 주세요.
00:01:25새로운 영상이 계속 올라옵니다.
00:01:27기본적으로 레포지토리를 클론하고 Docker Compose 파일을 추가한 다음,
00:01:31Docker Compose로 실행했습니다.
00:01:331분 만에 모든 설정이 완료되었으니, 전혀 복잡할 게 없죠.
00:01:37이제 새 노트북을 만들고 시작할 준비가 되었습니다.
00:01:40메모를 만들고 제목을 추가할 수 있습니다.
00:01:43기본적으로 Notion과 거의 똑같이 작동합니다.
00:01:46그리고 이제 코드 블록을 추가할 수 있습니다.
00:01:48Python 코드를 조금 넣어보겠습니다.
00:01:50이 블록을 다른 곳에도 임베드해보겠습니다.
00:01:54여기서 핵심적인 순간이 옵니다.
00:01:55원본 블록을 이동해도 참조는 여전히 유효합니다.
00:01:59링크가 깨질 일이 전혀 없죠.
00:02:01이것이 우리의 생각 방식과 작업 방식을 바꿔놓습니다.
00:02:04정보가 어디에 저장되어 있는지 걱정할 필요 없이, 어디에 유용한지에만 집중할 수 있습니다.
00:02:09이제 간단한 작업 데이터베이스를 만들어 보죠.
00:02:12버그 항목을 하나 추가하겠습니다.
00:02:14상태를 지정하고 우선순위도 설정할 수 있습니다.
00:02:16SQL이 내장되어 있어 메모 안에서 직접 쿼리를 실행할 수 있습니다.
00:02:23여기에 그래프 뷰를 통해 모든 것이 어떻게 연결되어 있는지 확인할 수 있습니다.
00:02:26이 그래프 뷰는 정말 대단하고, 저는 이 기능을 정말 좋아합니다.
00:02:30이것이 이 도구의 핵심 아이디어입니다.
00:02:31안정적인 블록, 실제 데이터베이스, 그리고 이 그래프를 통해 유지되는 구조를
00:02:37직접 상호작용하며 데이터베이스 내의 모든 핀이 어떻게 연결되었는지 볼 수 있습니다.
00:02:43정말 유용하죠.
00:02:45그렇다면 우리가 이미 사용하는 도구들과는 어떻게 다를까요?
00:02:47Obsidian은 모든 것이 파일 기반입니다.
00:02:50반면 Siyuan은 모든 것이 블록 기반입니다.
00:02:53즉, 페이지 전체를 연결하는 것이 아니라,
00:02:55그 안의 정확한 지식 조각을 연결하는 것입니다.
00:02:58결정 사항, 버그, 코드 조각 등 무엇이든 될 수 있죠.
00:03:00그게 차이점입니다.
00:03:01Obsidian이 아주 강력한 메모 폴더 같은 느낌이라면,
00:03:04Siyuan은 구조화된 시스템에 가깝고, 플러그인을 찾을 필요 없이
00:03:09데이터베이스와 SQL을 제공합니다.
00:03:10이제 Notion과 비교해 봅시다.
00:03:12Notion도 구조를 제공하지만, 역시 클라우드 기반입니다.
00:03:16Siyuan은 동일한 구조를 로컬에서 오프라인으로, 오픈 소스로 제공합니다.
00:03:21비용을 지불할 필요도 없죠.
00:03:22개발자들은 이를 프로젝트 문서, 코드 조각, 개인 위키, 지식 베이스로 활용합니다.
00:03:29기본적으로 로컬 기반의 오픈 소스 '제2의 뇌'이면서,
00:03:34시스템 설계 문서처럼 구조화되어 있습니다.
00:03:35Notion과
00:03:36Obsidian처럼 말이죠.
00:03:37솔직하게 평가하자면, 이 도구는 정말 훌륭합니다.
00:03:40업데이트가 빠르고 Docker를 통한 셀프 호스팅도 1, 2분이면 충분합니다.
00:03:45블록 참조 덕분에 방대한 메모도 안정적으로 관리할 수 있으며,
00:03:51클라우드에 의존하지 않고도 강력한 데이터베이스 구조를 가질 수 있습니다.
00:03:54하지만 반대로, 장점이 아닌 단점도 언급해야겠죠.
00:03:59단점은 Siyuan이 모든 것을 일반 마크다운으로 저장하지 않는다는 점입니다.
00:04:03 ".sy"라는 독자적인 형식을 사용합니다.
00:04:06이 점은 유의하셔야 합니다.
00:04:08마크다운으로 내보낼 수는 있지만 시스템 자체에 내장된 방식은 아닙니다.
00:04:11중국 기반 도구라 영어권 플러그인 시장이 훨씬 작다는 점도 있습니다.
00:04:17UI가 약간 구식이라고 느끼는 분들도 있겠지만, 제 눈엔 그냥 Notion처럼 보입니다.
00:04:21워크스페이스가 아주 커지면 가끔 최적화 작업을 해줘야 할 수도 있습니다.
00:04:25이 도구를 사용해야 할지 결정하는 가장 간단한 방법은 이렇습니다.
00:04:29대부분 마크다운 파일과 플러그인 위주로 구성되어 있다면 Obsidian이 여전히 낫습니다.
00:04:34하지만 메모가 문서화, 시스템, 장기적인 지식으로 변하고 있다면 Siyuan이
00:04:40훨씬 더 좋게 느껴지기 시작할 것입니다.
00:04:42구조화된 데이터, 강력한 연결, 완전한 제어권을 원한다면 사용해 보세요.
00:04:46제 개인적인 의견요?
00:04:47노트를 정리하는 새로운 방법을 찾고 있고 아직 Notion에 깊이 발을 들이지 않았다면
00:04:51이 도구를 추천합니다.
00:04:53하지만 솔직해집시다.
00:04:54이미 Notion을 오래 사용해왔다면, 이 도구로 옮기는 과정은
00:04:58정말 고통스러울 것입니다.
00:05:00그럴 때는 그냥 Notion이나 Obsidian을 계속 쓰는 게 낫습니다.
00:05:03만약 현재 시스템이 한계에 부딪혔다면, 시도해 볼 가치가 충분합니다.
00:05:06이 도구는 정말 훌륭하니까요.
00:05:08특히 지식 베이스 그래프 차트를 활용하는 것은 정말 유용합니다.
00:05:11이런 오픈 소스 코딩 도구와 팁이 마음에 드신다면, Better Stack
00:05:15채널을 꼭 구독해 주세요.
00:05:16그럼 다음 영상에서 뵙겠습니다.

Key Takeaway

SiYuan은 영구 블록 ID와 내장 SQL을 활용하여 파편화된 메모를 코드처럼 리팩토링 가능한 구조화된 시스템으로 변환하는 오픈 소스 지식 도구입니다.

Highlights

  • SiYuan은 각 단락, 리스트, 코드 블록에 고유한 영구 ID를 부여하여 내용을 이동해도 링크가 깨지지 않는 블록 기반 연결 시스템을 갖추고 있습니다.

  • 내장된 SQL 쿼리 기능을 통해 메모 안에서 직접 데이터를 검색하고 추출하며 데이터베이스를 제어할 수 있습니다.

  • Docker Compose를 사용하여 1분 이내에 로컬 환경이나 자체 서버에 지식 베이스를 구축할 수 있는 셀프 호스팅 기능을 제공합니다.

  • 파일 기반인 Obsidian과 달리 SiYuan은 모든 정보를 블록 단위로 관리하며 내장 데이터베이스 기능을 기본으로 포함합니다.

  • 데이터는 일반 마크다운 파일이 아닌 독자적인 .sy 파일 형식으로 저장되며 필요한 경우 마크다운 내보내기 기능을 활용해야 합니다.

  • 지식 베이스 그래프 뷰 기능을 통해 데이터베이스 내의 모든 블록이 어떻게 연결되어 있는지 시각적으로 확인하고 상호작용할 수 있습니다.

Timeline

개발자를 위한 코드형 메모 시스템의 정의

  • 메모를 단순한 텍스트 파일이 아닌 코드처럼 리팩토링 가능한 구조로 관리합니다.
  • 영구 블록 ID와 내장 SQL을 통해 정보의 구조적 안정성을 확보합니다.
  • 사용자가 직접 데이터를 관리하는 로컬 셀프 호스팅 제어 기능을 우선합니다.

파편화된 마크다운 파일과 끊긴 링크로 가득한 기존 메모 방식의 한계를 해결하기 위해 등장했습니다. 정보의 조각들을 연결하고 재구성하는 과정에서 시스템 설계 문서와 유사한 작동 방식을 보여줍니다. 데이터 소유권과 강력한 기능 사이의 균형을 맞추는 데 집중합니다.

블록 기반 아키텍처와 로컬 구축 방법

  • 모든 단락과 리스트는 고유한 ID를 가진 독립된 블록으로 작동합니다.
  • Docker Compose 파일을 사용하여 1분 만에 환경 설정을 완료하고 실행할 수 있습니다.
  • 내용을 다른 위치로 옮기거나 참조를 임베드해도 연결 상태가 영구적으로 유지됩니다.

페이지 전체를 연결하는 대신 특정 지식 조각을 연결하는 방식을 취합니다. Docker를 통한 간편한 설치 과정은 개발자 친화적인 환경을 제공합니다. 원본 데이터를 이동하더라도 참조가 깨지지 않으므로 복잡한 문서 구조를 안정적으로 유지합니다.

데이터베이스 기능 및 SQL 쿼리 활용

  • 버그 추적 및 작업 관리를 위한 실시간 데이터베이스 생성이 가능합니다.
  • SQL 쿼리를 메모 본문에 삽입하여 조건에 맞는 데이터를 동적으로 호출합니다.
  • 시각화된 그래프 뷰를 통해 지식 간의 유기적 연결 고리를 탐색합니다.

사용자는 Python 코드 블록을 작성하거나 버그 상태와 우선순위를 지정하는 데이터베이스를 구축할 수 있습니다. 메모 시스템 내에 SQL 환경이 통합되어 있어 별도의 플러그인 없이도 복잡한 데이터 조작이 가능합니다. 그래프 뷰는 데이터베이스 내의 핀들이 연결된 모습을 직관적으로 보여주며 지식의 흐름을 파악하게 돕습니다.

Obsidian 및 Notion과의 비교 분석

  • Obsidian의 파일 중심 방식과 달리 정교한 블록 단위 연결을 지원합니다.
  • Notion과 유사한 구조를 제공하면서도 오프라인 환경과 오픈 소스 기반의 자유도를 보장합니다.
  • 업데이트 주기가 빠르며 Docker 기반 셀프 호스팅으로 데이터 보안을 강화합니다.

Obsidian이 강력한 메모 폴더라면 SiYuan은 구조화된 지식 시스템에 가깝습니다. Notion의 클라우드 의존성을 제거하고 로컬 시스템에서 동일한 사용자 경험을 제공합니다. 프로젝트 문서화나 개인 위키 구축 등 시스템 설계 관점에서의 메모 정리에 최적화되어 있습니다.

사용 시 주의사항 및 최종 선택 기준

  • 데이터는 일반 마크다운이 아닌 전용 .sy 형식으로 저장됩니다.
  • 중국 기반 커뮤니티 특성상 영어권 플러그인 생태계가 상대적으로 협소합니다.
  • 기존 Notion 사용자가 데이터를 이전하는 과정에는 기술적 부담이 따릅니다.

범용 마크다운 형식을 고수해야 한다면 Obsidian이 더 나은 선택일 수 있습니다. 하지만 메모의 성격이 장기적인 지식 시스템으로 진화하고 있다면 SiYuan의 구조화된 데이터 방식이 유리합니다. 데이터가 방대해질 경우 최적화 작업이 필요할 수 있으며 사용자 환경에 따라 UI에 대한 호불호가 갈릴 수 있습니다.

Community Posts

View all posts