Obsidian Vault를 Flexnote로 가져오는 방법

노트 앱을 바꿀 때 가장 어려운 것은 새 앱 쓰는 법을 배우는 일이 아닙니다. 옛 라이브러리를 옮기는 일입니다. 성숙한 Obsidian Vault에는 Markdown 파일 이상이 들어 있습니다: 폴더, 태그, 위키 링크, 이미지, PDF, 그리고 늘어놓는 데 몇 시간이 걸렸을지도 모르는 Canvas 보드. 빈 작업 공간에서 다시 시작하는 것은 현실적인 선택이 아닙니다.

Flexnote는 이제 로컬 Obsidian Vault 를 직접 읽을 수 있습니다. Vault 전체를 가져오거나, 몇몇 최상위 폴더만 고를 수 있습니다. Markdown 노트는 카드가 되고, 원래 폴더 구조는 사이드바의 「Ob导入」 컬렉션에 나타납니다. Canvas 가져오기를 켜면 텍스트, 노트, 그룹, 첨부, 연결도 변환됩니다.

Flexnote는 무엇을 가져올 수 있는가?

가져오기는 Markdown 텍스트 복사 이상을 합니다. 먼저 Vault 를 스캔하고, 대응하는 각 콘텐츠 종류를 변환합니다.

알아 두면 좋은 변환 규칙

폴더는 내비게이션으로 유지된다

「Research / Paper A / Literature Notes」 같은 Vault 경로는 「Ob导入」 컬렉션 아래에서 같은 중첩 경로가 됩니다. 카드는 Flexnote 의 카드 라이브러리에도 들어가고, 컬렉션은 그 익숙한 경로를 유지합니다.

태그는 Flexnote의 태그 시스템에 들어간다

YAML Properties에 태그가 있으면, 가져오기는 그것을 우선합니다. 없으면 본문의 인라인 #tags 를 읽습니다. 인라인 태그가 카드에 붙은 뒤, 노트 본문에서 중복된 마커는 삭제됩니다.

위키 링크는 가능한 한 의도한 노트를 가리킨다

[[Note]], 경로 기반 링크, [[Note|Alias]] 는 가져오기 대상 노트에 대해 대조됩니다. 맞으면 대응하는 카드를 여는 링크가 됩니다. 해결되지 못한 링크는 제목을 남기고, 나중에 찾거나 다시 이을 수 있습니다.

Obsidian 고유 표기는 변환된다

Callout은 아이콘이 있는 인용 블록이 되고, Obsidian 주석은 삭제되며, 각주, 작업 목록, 하이라이트, 위 첨자, 아래 첨자, details 블록은 Flexnote 편집기가 이해하는 형식으로 변환됩니다. 테마 스타일, 플러그인 정의 표기, 태그 외 Properties 는 정확히 옮기지 못할 수 있으니, 가장 복잡한 노트 몇 개를 확인하세요.

Obsidian Vault 가져오기 절차

1단계: 가져오기를 열고, Obsidian Vault를 고른다

Flexnote 사이드바에서 컬렉션을 열고, 가져오기 화면에 들어가, 「Obsidian Vault」를 고릅니다. 데스크톱 앱은 기기에 등록된 Vault 를 나열하려 하고, 최근에 연 Vault 가 먼저 나옵니다. 없으면 다른 폴더를 골라 Vault 루트를 수동으로 지정합니다.

2단계: 옮길 폴더를 고른다

Flexnote는 Vault 루트와 각 최상위 폴더 안의 노트와 Canvas 파일을 셉니다. 전부를 골라도, 진행 중인 프로젝트와 강의 노트만 먼저 옮겨도 됩니다. 단계적 이전이 아카이브를 넣기 전에 서식과 링크를 확인하기 쉽습니다.

「Import Canvas boards」는 기본으로 켜져 있습니다. 이번엔 Markdown 만 원하면 끕니다. 원본 Canvas 파일은 Vault 에 남고, 나중에 가져올 수 있습니다.

3단계: 가져오고, 「Ob导入」 컬렉션을 확인한다

진행 뷰는 현재 파일과 전체 완료 상황을 보여줍니다. 끝나면 사이드바의 「Ob导入」를 펼쳐, 원래 경로 아래의 가져온 노트와 보드를 찾습니다. 결과 요약은 신규 노트, 갱신 노트, 신규 보드, 갱신 보드, 건너뜀, 복구된 컬렉션 항목으로 나뉩니다.

Obsidian Canvas는 어떻게 되는가?

Obsidian Canvas와 Flexnote 화이트보드는 데이터 모델이 다르므로, 가져오기는 Canvas JSON 을 그대로 넣지 않고, 객체 종류마다 변환합니다. 위치, 크기, 색, 그룹화, 연결 방향을 유지하는 것을 목표로 합니다.

• 텍스트 노드는 Markdown 변환이 있는 화이트보드 텍스트가 된다.
• Markdown 파일 노드는, Vault에서 가져온 노트 카드를 참조한다.
• 이미지, 영상, 음성은 미디어 카드가 되고, PDF는 PDF 카드가 된다.
• 그 외 첨부는 파일 노드, 웹 링크는 웹사이트 카드가 된다.
• 그룹은 화이트보드 그룹이 되고, 포함된 객체는 공간 위치에서 복원된다.
• 에지는 레이블, 색, 방향, 화살표 스타일이 있는 연결이 된다.

Canvas 가 빠진 파일을 참조하고 있으면, Flexnote 는 그 부분을 조용히 지우지 않고, 원래 파일 이름을 포함한 텍스트 노드를 남깁니다. 렌더러가 다르므로, 깊게 중첩된 그룹, 특수한 색, 플러그인 정의 노드 종류는 나중에 조정이 필요할 수 있습니다.

두 번째 가져오기는 중복을 만드는가?

기본으로는 만들지 않습니다. Flexnote 는 가져온 모든 노트와 Canvas 에 대해, Vault 안의 상대 경로를 기록합니다. 같은 경로를 다시 보면, 이미 가져온 것으로 다루고, 세 가지 정책을 제시합니다:

• Skip existing： Flexnote 쪽 판을 남기고, 새 파일만 가져오기. 단계적 이전에서는 기본이며, 가장 안전한 선택입니다.
• Overwrite existing： Obsidian 의 원본 노트로 갱신. Canvas에 대해 Flexnote 는 보드 항목을 남기고, 객체를 지운 뒤 다시 구축합니다. 먼저 Flexnote만의 편집이 없는지 확인하세요.
• Collections only： 노트와 보드는 만들지 않고 바꾸지도 않으며, 빠진 사이드바 항목만 복원합니다.

더 안전한 이전 순서

몇 년에 걸쳐 만든 Vault에서는, 한 번에 전부 옮기는 데 상이 없습니다. 이 순서로:

1. Obsidian Vault와 Flexnote 데이터 둘 다 백업한다.
2. 태그, 링크, 이미지, Canvas 를 포함한 작은 폴더 하나를 고른다.
3. 가져온 뒤 폴더 구조, 복잡한 노트 몇 개, 바쁜 Canvas 하나를 확인한다.
4. 테스트가 맞으면, 나머지 폴더를 가져온다.
5. 이후 증분 가져오기에는 「Skip existing」을 쓰고, 소스 파일로 Flexnote 편집을 바꿀 때만 「Overwrite」를 고른다.

가져오기는 다른 워크플로를 시험하는 비용을 낮추지만, 하룻밤에 전환을 강제하지는 않습니다. 고른 비주얼 프로젝트를 Flexnote 로 옮기면서 Obsidian 에서 계속 써도 되고, 라이브러리 전체를 이전한 뒤 카드 라이브러리에서 검색하고, 중요한 노트를 화이트보드에 늘어놓아도 됩니다. 실제 프로젝트 하나를 시험하는 편이, 기능 비교를 한 바퀴 더 도는 것보다 많이 알려 줍니다.