Obsidian 플러그인 가이드 (베타)
VS Code 확장 프로그램과 마찬가지로 Obsidian 플러그인은 문맥 인식 OCR을 제공하여 WriteTex 앱과 Obsidian 간의 원활한 통합을 통해 더 정확한 성능을 가능하게 합니다.
경고: 이 플러그인은 현재 집중 개발 중이며 어떠한 보증도 제공하지 않습니다. 사용에 따른 위험은 사용자가 감수해야 합니다. LICENSE를 참조하십시오. 현재 플러그인을 사용하려면 타사 제공업체(예: OpenAI)의 작동하는 API 설정이 있어야 합니다.
주요 기능
- WriteTex 앱의 동반자: WriteTex 모바일 앱을 데스크톱 Obsidian 에디터와 원활하게 연결합니다.
- 문맥 인식: 커서 주변의 텍스트를 자동으로 AI에 전송하여 현재 문서의 스타일과 변수를 이해함으로써 정확도를 높입니다.
- 직접 삽입: 생성된 코드가 커서 위치에 즉시 삽입됩니다.
설치 방법
- GitHub 저장소에서 최신 릴리스를 다운로드합니다.
main.js와manifest.json을 보관소(Vault)의 플러그인 디렉토리에 넣습니다:<VAULT>/.obsidian/plugins/writetex-obsidian/.- Obsidian 설정 -> **커뮤니티 플러그인 (Community Plugins)**을 열고 WriteTex를 활성화합니다.
Obsidian 플러그인을 사용하기 위해 WriteTex 데스크톱 버전을 설치할 필요는 없습니다. iPad/태블릿의 모바일 앱만 있으면 됩니다.
설정 안내
이 부분은 다른 플랫폼의 설정과 유사합니다. 간단한 예시는 다음과 같습니다.
| 설정 항목 | 설정값 |
|---|---|
| API 엔드포인트 | https://api.openai.com/v1 |
| 모델 | gpt-5 |
| API 키 | sk-... |
사용자 지정 지침 (Custom Instructions)
AI 모델을 안내하기 위한 추가 프롬프트입니다. 예를 들어, "허수 단위에 \mathbb{i}를 사용하세요."와 같은 내용을 추가할 수 있습니다.
사용 방법
서버 시작:
- 서버는 Obsidian이 로드될 때 자동으로 시작됩니다.
- 오른쪽 하단의 상태 표시줄을 확인하세요: **"WriteTex: On"**이라고 표시되어야 합니다.
- "Off"라고 표시되면 명령 팔레트(
Cmd/Ctrl + P)를 열고 **"WriteTex: Start Server"**를 실행합니다.
클라이언트 연결 (예: iOS 앱):
- 휴대폰에서 WriteTex 앱을 엽니다.
- 휴대폰과 컴퓨터가 동일한 Wi-Fi 네트워크에 있는지 확인하세요.
- 앱이 자동으로 "WriteTex Obsidian @ [사용자 호스트 이름]"을 검색해야 합니다.
- 자동 검색에 실패하면 컴퓨터의 IP 주소를 수동으로 입력하세요.
다른 플랫폼(Windows, Android, MacOS)의 경우 VS Code 가이드를 따르세요.
- 손글씨 수식 삽입:
- 코드를 삽입하려는 Obsidian 노트에 커서를 놓습니다.
- 모바일 앱을 사용하여 수학 공식을 씁니다.
- 플러그인이 이미지를 수신하고 현재 노트의 문맥과 함께 분석하여 LaTeX/Markdown 결과를 에디터에 직접 삽입합니다.
문제 해결
- 서버가 시작되지 않음:
50905포트가 다른 애플리케이션에서 사용 중인지 확인하세요. VS Code 확장 프로그램에서 WriteTex 서버를 활성화한 경우 Obsidian을 실행하기 전에 비활성화하세요. - 모바일 앱 연결 불가:
- 두 기기가 동일한 Wi-Fi에 있는지 확인하세요.
- 컴퓨터의 방화벽 설정에서
50905포트의 인바운드 연결을 허용하는지 확인하세요. - 일부 학교나 기업 네트워크에서는 기기 간 연결을 차단할 수 있습니다. 이 경우 VPN이나 핫스팟 사용을 시도해 보세요.
- "Unauthorized" 오류: 클라이언트 앱이 API 키
writetex를 전송하는지 확인하세요.