Obsidian 플러그인 문제 해결

BrainTube Obsidian 플러그인에서 자주 생기는 문제와 해결 방법이에요.

API 키 문제

설정 → API 키에서 새 키를 생성하세요. 끝에 공백 없이 키 전체를 복사했는지 확인하세요. 키는 내 계정에 연결돼요.

동기화가 시작되지 않을 때

1. Obsidian 설정에서 플러그인이 활성화되어 있는지 확인하세요
2. 인터넷 연결을 확인하세요
3. Obsidian 콘솔에서 오류 메시지를 확인하세요
4. 플러그인을 비활성화했다가 다시 활성화해 보세요

노트가 BrainTube에 나타나지 않을 때

• 동기화 후 처리에 30~60초가 걸릴 수 있어요
• 동기화 폴더 설정을 확인하세요
• 프런트매터만 있고 내용이 없는 노트는 동기화에서 제외될 수 있어요

서식 문제

• Obsidian 전용 문법(콜아웃)은 그대로 유지돼요
• 위키링크는 표준 마크다운 링크로 변환돼요
• 임베드된 파일과 이미지는 참조만 되고 업로드되지는 않아요

플러그인 업데이트

최신 수정 사항을 받으려면 Obsidian에서 자동 업데이트를 켜세요. 메이저 업데이트 전에는 변경 내역에서 호환성이 깨지는 변경이 있는지 확인하세요.