Obsidian 볼트를 OKF로 옮기고 Obsidian을 계속 쓰기

Obsidian을 떠나지 않고도 Obsidian 볼트를 OKF로 마이그레이션할 수 있어요. Obsidian 볼트는 맨 위에 YAML 속성이 있는 마크다운 파일들의 폴더예요. OKF 번들은 맨 위에 YAML frontmatter가 있는 마크다운 파일들의 폴더예요. Google Cloud가 공개한 개방형 사양인 Open Knowledge Format은 문서가 무엇인지, 누가 썼는지, 누가 확인했는지, 언제 오래된 상태가 되는지 기록하는 필드 몇 개를 더해요. Knowtarium은 이 필드를 읽어 모든 노트를 누가 썼는지(그리고 검토가 켜진 폴더에서는 누가 확인했는지) 보여 줘요. 그래서 마이그레이션은 작은 일이에요.

마이그레이션 후 Obsidian에서 달라 보이는 점이 하나 있어요. Obsidian의 속성 보기는 중첩된 속성을 지원하지 않는데, generated와 verified는 중첩되어 있으므로 소스 모드에서 읽어야 해요. 노트 자체는 전과 똑같이 열려요.

모든 파일을 건드리는 마이그레이션에는 되돌리기 버튼이 있어야 해요. 마이그레이션 스킬은 변환된 사본을 쓰고 볼트는 절대 바꾸지 않지만, 직접 마이그레이션하면 파일 자체를 수정하게 돼요. 볼트가 아직 git에 없다면 git에 넣고 커밋하세요. 그러면 정확히 무엇이 바뀌었는지 보고 되돌릴 수 있어요.

$ cd ~/vault$ git init$ git add -A && git commit -m "Vault before OKF migration"
 
# OKF가 예약한 이름을 쓰는 노트
$ find . \( -name index.md -o -name log.md \) -not -path "./.obsidian/*"

마지막 명령이 중요해요. OKF에서 index.md와 log.md는 모든 단계에서 예약된 이름이에요. index.md는 폴더의 내용을 나열하고 log.md는 변경을 기록해요. 마이그레이션 스킬은 이런 이름의 노트를 index-note.md와 log-note.md로 바꾸고 그 노트로 가는 링크도 업데이트해요. 직접 마이그레이션한다면 먼저 Obsidian에서 이름을 바꾸세요. Settings, Files and links에서 "Automatically update internal links"를 켜 두면 Obsidian이 링크를 대신 업데이트해 줘요.

볼트를 동기화하고 있다면 시작하기 전에 동기화가 끝나기를 기다리고, 다른 기기에서는 편집을 멈추세요.

Knowtarium에는 변환을 대신 해 주는 무료 마이그레이션 스킬이 있어요. 누구나 무료로 쓸 수 있고 계정도 필요 없어요. Claude Code, Codex, Cursor 같은 에이전트가 무료 knowtarium 명령줄 도구로 이 스킬을 실행하는데, 이 도구는 볼트를 읽고 변환된 사본을 새 폴더에 써요. 볼트 자체는 절대 바뀌지 않고, 직접 쓴 내용도 그대로예요.

1. 각 노트에 없는 OKF 필드를 추가해요. type, 제목, 설명(노트의 첫 단락), 그리고 쓴 사람(마이그레이션 시점의 나)이에요. stale_after는 비워 두므로 첫날부터 오래된 것으로 표시되는 노트는 없어요. 만료 날짜는 필요한 노트에 직접 추가하세요.
2. 위키링크와 임베드를 표준 마크다운 링크로 바꿔서, 모든 도구가 따라갈 수 있게 해요. 첨부 파일은 그 자리에 그대로 있어요.
3. 직접 만든 속성은 그대로 두고, 모든 폴더에 index.md를 써요. 볼트에 이미 index.md나 log.md라는 노트가 있으면 index-note.md와 log-note.md로 이름을 바꾸고 링크를 업데이트해요.
4. 사본을 폴더나 zip으로 Knowtarium 워크스페이스에 가져와요. (스킬을 건너뛰고 싶다면, 가져오기 기능도 Obsidian 볼트를 같은 방식으로 직접 변환해요.)

사본이 원본 옆에 있으므로 마이그레이션 전체를 하나의 diff로 읽을 수 있어요. 두 폴더를 대상으로 git diff --no-index --stat을 실행하면 frontmatter와 링크의 변경, 새 index.md 파일들, 루트의 log.md, 변환 보고서(.knowtarium/conversion-report.md), 그리고 index-note.md나 log-note.md로 이름이 바뀐 노트만 보여야 해요. 직접 쓴 단락이 바뀐 것으로 나오면, 그대로 두기 전에 살펴보세요.

도구가 없어도 할 수 있어요. OKF는 일반 frontmatter라서, 작은 볼트라면 오후 한나절이면 끝나요. 다음은 한 노트의 전과 후예요.

---
tags: [pricing, sales]
aliases: [Plans]
owner: maya
---
 
Pro는 9월부터 월 €14예요. [[Annual plans]] 참고.

---
type: Note
tags: [pricing, sales]
aliases: [Plans]
owner: maya                                # 직접 만든 키는 그대로
generated: { by: human:maya, at: 2026-03-02T10:00:00Z }
stale_after: 2027-03-01T00:00:00Z
---
 
Pro는 9월부터 월 €14예요. [Annual plans](Annual%20plans.md) 참고.

1. 모든 노트에 type 추가하기

type은 유일한 필수 필드예요. OKF에는 정해진 type 목록이 없으니, 이미 생각하는 방식에 맞는 설명적인 type을 몇 개 고르세요. Note, Meeting, Person, Decision, Reference 같은 것들이요. type만 있는 노트도 이미 유효한 OKF예요.

2. 누가 썼는지 기록하기

행위자와 시각을 담은 generated를 추가하세요. 직접 쓴 노트에는 human:과 이름을 쓰세요. AI가 쓴 노트에는 claude-code/2.1처럼 도구와 버전을 쓰세요. 시각은 2026-03-02T10:00:00Z처럼 UTC 오프셋이 있는 ISO 8601 형식이에요. 정확한 시각을 모르면 파일 날짜로 충분히 추정할 수 있어요.

직접 썼고 지금도 내용을 보증하는 노트에는 같은 시각으로 verified에 자신을 추가하세요. AI가 쓴 노트는 다시 읽어 보기 전까지 verified를 넣지 마세요.

3. 언제 오래된 상태가 되는지 적기

가격, 플랜, “현재”라는 말이 들어간 것처럼 유효 기간이 있는 노트에는 stale_after를 추가하세요. 시간이 지나도 변하지 않는 노트에는 없어도 돼요.

4. 마크다운 링크로 바꾸기

Obsidian에서 Settings를 열고 Files and links로 가서 "Use [[Wikilinks]]"를 끄고, "New link format"을 "Relative path to file"로 설정하세요. 그러면 새 링크는 표준 마크다운이 돼요. 기존 위키링크는 직접, 또는 에이전트에게 부탁해서 변환해야 해요. 마크다운 링크에서는 파일 이름의 공백을 %20으로 써요.

Knowtarium에서는

OKF에서는 존재하지 않는 노트로 가는 링크가 오류가 아니에요. Knowtarium은 이런 링크를 그래프에 유령으로 그려서, 변환 중에 깨진 링크를 쉽게 찾을 수 있어요.

(새 탭에서 원래 크기로 열림) (새 탭에서 원래 크기로 열림)

5. 인덱스 쓰기

루트에, 그리고 도움이 되는 폴더마다 index.md를 추가하세요. frontmatter 없이 제목과 문서마다 짧은 설명이 붙은 한 줄로만 이루어져요.

# 가격
 
* [Pricing](pricing.md) - 현재 플랜과 가격
* [Annual plans](Annual%20plans.md) - 연간 결제로 바꾼 이유
 
# 고객
 
* [Interviews](customers/interviews/) - 고객 통화마다 노트 하나

최신 항목이 먼저 오도록 YYYY-MM-DD 제목 아래 변경을 기록하는 log.md는 선택 사항이에요.

스킬로 했든 직접 했든 결과는 OKF 번들이고, Knowtarium은 폴더나 zip에서 이를 하나의 번들로 워크스페이스에 가져와요. 먼저 필요한 저장 공간이 담긴 보고서가 나오고, 그다음 모든 노트가 기기에서 암호화되어 업로드되므로 저희는 아무것도 읽을 수 없어요(연결한 에이전트는 자신이 읽는 내용을 봐요).

(새 탭에서 원래 크기로 열림) (새 탭에서 원래 크기로 열림)

그때부터 다음과 같은 것을 볼 수 있어요.

• 모든 노트를 누가 썼는지를 generated에서 읽어 보여 줘요. 검토가 켜진 폴더에서는 verified가 누가 확인했는지도 보여 줘요. human-reviewed이거나, 누군가 확인할 때까지 unverified예요. stale_after가 지난 노트는 Stale and expiring 페이지에 나열돼요.
• 링크 그래프. 무엇이 오래되었는지 보여 주고, 검토가 켜져 있으면 노트를 신뢰 등급별로 색칠할 수 있어요. 아직 아무도 쓰지 않은 노트로 가는 링크는 유령이에요.
• 모든 변경은 서명되고 되돌릴 수 있어요. 에이전트의 변경은 즉시 저장되고, 에이전트 자신의 키로 서명되고, 노트에 표시되며, Undo 한 번이면 되돌릴 수 있어요. 폴더에 검토를 켜면 그 폴더에서는 에이전트의 변경이 대신 승인을 기다려요.
• 검색과 기록. 브라우저에서 실행되는 워크스페이스 전체 전문 검색, 그리고 원하는 기간 동안 모든 버전을 그 버전을 만든 서명된 변경과 함께 보관해요.

에이전트는 npx knowtarium connect로 연결하고 MCP로 노트를 다뤄요. 검토가 켜진 폴더에서 노트를 바꾸면, 에이전트에게 연결된 모든 것과 대조해 확인해 달라고 요청할 수 있어요. Knowtarium은 직접 AI를 호출하지 않고, 직접 만든 속성과 댓글, 서식을 그대로 유지하며, 언제든지 워크스페이스나 폴더를 일반 마크다운으로 내보낼 수 있어요.

Knowtarium은 종단간 암호화 웹 앱이에요. 각 앱이 어떤 용도인지 나란히 비교하려면 Knowtarium vs Obsidian을 보세요.

마이그레이션 후에도 새 폴더는 여전히 볼트예요. 스킬이 Obsidian 설정을 번들 옆에 복사하므로 Obsidian이 전과 똑같이 열고, 그곳에서 Obsidian을 계속 쓸 수 있어요. Knowtarium에도 가져온다면 워크스페이스는 자체 암호화 사본을 갖고, 둘은 서로 동기화되지 않아요. 어디서 편집할지 정하고, 파일을 다시 받고 싶을 때는 Knowtarium에서 일반 마크다운으로 내보내세요. 번들을 깔끔하게 유지하는 습관 몇 가지가 있어요.

• 새 노트는 이 형식으로 시작하세요. 템플릿으로 노트를 만든다면 템플릿에 type과 서명을 넣고, Obsidian의 속성 패널이 변수를 덮어쓰지 않도록 값을 따옴표로 감싸세요.

---
type: Note
generated: { by: "human:maya", at: "{{date:YYYY-MM-DDTHH:mm:ssZ}}" }
---

• 마크다운 링크를 고수하세요. 위키링크를 다시 켜면 새 링크는 다른 도구가 읽을 수 없어요. 임베드나 콜아웃 같은 Obsidian 전용 문법은 다른 곳에서 같은 모습으로 보이지 않을 수 있어요.
• 동기화는 여전히 직접 관리해요. Knowtarium은 워크스페이스를 디스크의 폴더가 아니라 브라우저들 사이에서 맞춰 주며, 아직 휴대폰 앱은 없어요. 지금 볼트 폴더를 동기화하는 방법을 그대로 쓰세요. 파일은 일반 마크다운이라 git도 함께 쓸 수 있어요.

출처 정보가 갖춰지면 볼트는 함께 쓰는 에이전트를 맞을 준비가 돼요.

• AGENTS.md나 CLAUDE.md로 에이전트에게 규칙을 주세요. 저희의 지식 베이스용 템플릿은 위의 필드와 맞아요.
• 에이전트를 위한 인용 규칙으로, 에이전트가 쓰는 모든 주장에 출처를 요구하세요.
• 변경이 자리 잡기 전에 검토하세요: 에이전트의 변경을 검토하는 방법.