로컬 우선 마크다운 노트: 구독이 아니라 내 파일을 소유하기

로컬 우선 마크다운 노트는 노트가 회사 서버의 DB가 아니라 내 디스크의 평범한 .md 파일로 존재한다는 뜻이에요. 다른 파일처럼 열고, 고치고, 백업하면 돼요. 계정도, 동기화 서버도, 매달 나가는 구독료도 나와 내 글 사이에 끼어들지 않아요. 이미 에디터와 터미널에서 사는 개발자라면, 이게 가장 오래 가는 노트 방식이라고 생각해요. 이 글에서 왜 클라우드 노트 앱보다 낫다고 보는지 정리해볼게요.

저희가 로컬 우선 에디터를 만드는 입장이라 편향이 있는 건 인정해요. 하지만 이 글의 핵심은 특정 앱이 아니라 '포맷'과 '파일이 어디 있느냐'예요. 이 글을 읽고 마크다운 폴더에 git만 붙여 쓰게 돼도 성공이에요.

로컬 우선이 대체 뭔가요?

로컬 우선은 단순한 성질이에요. 데이터의 원본(source of truth)이 내 기기의 파일이고, 앱은 그 위에 얹힌 렌즈일 뿐이라는 거죠. 동기화가 있더라도 그건 내가 통제하는 선택 사항이지, 내 노트를 열기 위한 필수 조건이 아니에요. 클라우드 우선 도구는 이걸 뒤집어요. DB가 원본이고, 파일 내보내기는 손실 많은 부산물이 되죠.

테스트는 간단해요. 앱을 지워보세요. 모든 노트를 평범한 텍스트 에디터로 여전히 읽을 수 있나요? 로컬 우선 마크다운이면 '네'예요. 대부분의 클라우드 앱은 HTML 압축 파일이나 구조가 절반쯤 날아간 독점 포맷을 던져줘요.

왜 노트를 로컬 우선으로 두나요?

현업 개발자에게는 네 가지 이유가 대부분의 무게를 차지해요.

• —프라이버시: 내가 어디론가 보내지 않는 한 파일은 디스크를 떠나지 않아요. 기본값으로 업로드·색인·분석되는 게 없어요. 쓰다 만 생각도 온전히 내 것이에요.
• —지속성: 평범한 마크다운은 20년 뒤에도 읽혀요. 해독해야 할 독점 포맷도, 내 노트를 열기 위해 계속 존재해야 하는 회사도 없어요.
• —git 버전 관리: 노트 폴더는 그냥 소스 코드예요. 전체 히스토리, diff, 브랜치, blame이 공짜로 따라와요.
• —락인·구독 없음: 한 번 사거나 무료 에디터를 쓰면 되고, 마음이 바뀌는 날 다른 마크다운 도구로 그대로 옮길 수 있어요.

20년 뒤에도 읽히는 순수 텍스트

마크다운은 노트 필기가 가진 것 중 아카이브 포맷에 가장 가까워요. 사람이 읽을 수 있어서 도구가 하나도 없어도 메모장으로 .md를 열어 이해할 수 있고, 사실상 표준이라 이미 수백 개의 에디터가 파싱해요. diff도 잘 돼서 버전 관리가 불투명한 덩어리가 아니라 일급 텍스트로 다뤄요.

클라우드 블록 에디터에 갇힌 노트와 비교해보세요. 업체가 스키마를 바꾸거나, 제품을 종료하거나, 인수되는 순간 내 아카이브는 누군가가 계속 유지해줘야 하는 '내보내기 버튼'에 운명을 맡기게 돼요. 순수 파일에는 그런 의존성이 없어요. 파일 자체가 아카이브니까요.

git으로 마크다운 노트에 버전 붙이기

이게 클라우드 앱이 따라올 수 없는 부분이고, 설정에 1분이면 돼요. 노트 폴더에서 터미널을 열고 git init, 그다음 git add . 와 git commit -m "notes". 끝이에요. 이제부터 모든 수정은 커밋할 수 있고, 내 사고 과정의 완전한 타임스탬프 히스토리가 생겨요.

그다음부터는 익숙한 git 도구가 노트에 그대로 적용돼요. git diff 로 오늘 뭘 바꿨는지 정확히 보고, git log 로 과거 버전을 거슬러 올라가고, git checkout 으로 지난주에 지운 문단을 되살려요. 같은 폴더를 프라이빗 원격에 push하면 어떤 노트 앱의 클라우드도 끼지 않고 오프사이트 백업과 기기 간 동기화가 돼요.

모든 노트가 순수 텍스트라 git blame이 산문에도 먹혀요. 어떤 결정이 언제 적혔고 무엇을 대체했는지 볼 수 있죠. 이걸 주는 클라우드 노트 앱은 없어요.

클라우드 노트 앱이 진짜로 이기는 지점

로컬 우선에도 트레이드오프가 있고, 아닌 척하면 정직하지 않겠죠. 여러 명이 같은 문서를 동시에 편집해야 한다면 Notion 같은 클라우드 도구가 그냥 더 나아요. 실시간 협업, 댓글 스레드, 공유 링크, 관계형 데이터베이스는 파일 폴더가 잘 못하는 일이에요. 이 트레이드오프는 Tybre vs Notion 비교에서 자세히 다뤘어요.

그래서 솔직한 기준은 이거예요. 협업과 구조화된 DB가 핵심이면 클라우드 우선을, 노트가 대체로 내 것이고 프라이버시·지속성·통제가 중요하면 로컬 우선을 고르세요. 대부분 개발자의 개인 노트, 리서치, 저널은 두 번째에 딱 들어맞아요.

내 마크다운 폴더를 위한 로컬 우선 에디터

텍스트 에디터와 git만으로도 로컬 우선 노트를 충분히 굴릴 수 있어요. 하지만 WYSIWYG 에디터가 있으면 파일은 순수하게 두면서도 매일의 글쓰기가 훨씬 쾌적해져요. Tybre.md가 바로 그 자리예요. .md 폴더를 여는 ~5MB 네이티브 앱이고, syntax-reveal로 깔끔한 서식을 보여주면서 원본 마크다운은 키 한 번이면 드러나요. 클라우드 계정을 요구하지 않고, 파일은 git이 볼 수 있는 그 자리, 디스크에 그대로 있어요.

노트 폴더를 진짜 지식 베이스처럼 만들어주는 연결 조직도 있어요. 노트 사이 백링크를 드러내는 위키링크 그래프 뷰, 그리고 글 바로 옆에서 커밋할 수 있는 내장 터미널이요. 또 다른 인기 로컬 마크다운 도구와 저울질 중이라면, Tybre vs Obsidian 정리가 기능별로 공정하게 비교한 버전이에요.

클라우드 노트 vs 로컬 우선 마크다운 한눈에