¶ vault 가져오기 · 내보내기
¶ vault 등록
- 앱 설정의 Obsidian 메뉴에서 ‘vault 폴더 선택’ 으로 vault 폴더(
.obsidian이 있는 폴더)를 고릅니다. 고른 폴더에.obsidian/*.json이 없으면 vault 가 아니므로 등록하지 않습니다 (하위 폴더는 찾지 않음). - 표시 이름은 고른 vault 의 폴더 이름, ID 는 자동으로 채워집니다 (고칠 수 있음). 여러 vault 를 등록할 수 있으며 보관소 · 임시 영역 · 백업 · 로그 폴더와 겹치는 경로는 허용하지 않습니다.
- ‘저장하고 다시 시작’ 으로 서버에 적용한 뒤 웹의 Obsidian 메뉴에서 vault 와 폴더를 엽니다.
¶ 가져오기
- 가져올
.md파일을 선택하고 파일 묶음의 보관 권한 · 가져오기를 확인합니다. 한 번에 100 개, 합계 32 MiB 까지 가져옵니다. 숨김 폴더 · 링크 · 외부 경로는 제외합니다. - 원문을 그대로 보관하며 머리말의
tag: 개발,설계를basis=header인 내용 미확인 태그로 붙입니다. 본문의 해시태그와tags:배열은 자동 태그로 읽지 않습니다.
알려진 개인키 · 토큰 등 비밀 패턴이 발견되면 가져올 묶음 전체를 거부합니다. 모든 비밀을 검출하지는 못하므로 선택한 파일을 확인하세요. 디스크 오류 등으로 일부 파일만 완료됐으면 결과 목록을 확인하세요.
¶ 내보내기
원천 화면의 ‘Obsidian vault 로 내보내기’ 또는 Obsidian 메뉴에서 원천 해시를 지정하면 vault 의 docdosum/ 아래에 출처 · 태그 근거와 텍스트 파생 사본을 만듭니다.
- 기존 파일은 덮어쓰지 않으며, 같은 원천을 이미 내보냈으면 다시 만들지 않습니다.
- 출처는 파일 이름이 아니라 머리말의
docdosumkr_source_hash에 남습니다. - Markdown · UTF-8 텍스트 · HTML 및 이미 존재하는 텍스트 파생을 지원합니다. PDF 같은 형식은 지원되는 텍스트 파생이 없으면 거부합니다.
- 사본을 편집해도 자동 역동기화하지 않으며, 다시 가져올 때 출처 해시 표시를 함께 보고합니다.
¶ AI 에서
AI 는 GET /api/vaults 로 ID 를 확인하고 GET /api/vaults/{id}/files?dir=... 로 탐색합니다. 선택한 묶음을 확인한 뒤 JSON {"paths":["note.md"],"confirmed":true} 를 POST /api/vaults/{id}/import 에 보냅니다. 내보내기는 JSON {"hash":"원천 해시"} 를 POST /api/vaults/{id}/export 에 보냅니다. 두 작업의 성공 코드는 201 입니다.
이전: Obsidian 에 vault 열기 · 다음: 폴더와 이름 · 위로: Obsidian vault