Obsidian 플러그인 설명서, 0.6.6 기준
Zotero는 서재로,
Obsidian은 작업대로.
CMDS Zotero는 Zotero에서 읽고 표시한 것을 Obsidian 문헌 노트로 보내고, 원고의 인용을 citekey 하나로 다루며, 다 쓴 원고를 Word의 Zotero 인용으로 넘깁니다. Zotero는 읽기만 하고, 사람이 쓴 문장은 덮어쓰지 않습니다.
- Obsidian 데스크톱 1.7.2 이상
- Zotero와 Better BibTeX
- Zotero 데이터는 바꾸지 않음
- MIT 라이선스
세 가지 일
[@를 치면 인덱스에서 문헌을 찾아 citekey 인용을 넣습니다. 쪽수, 여러 문헌, 문제 있는 키 표시까지.
넘기기참고문헌과 WordObsidian 안에서 참고문헌을 만들거나, 원고를 Word로 넘겨 Zotero 플러그인이 이어서 관리하게 합니다.
전체 그림
세 앱이 각자 잘하는 일만 합니다. Zotero는 서지와 PDF와 주석을 보관하고, Obsidian은 생각과 원고를 담고, Word는 공저자와 투고처가 요구하는 형식을 맞춥니다. 그 사이를 오가는 것은 citekey라는 짧은 주소 하나입니다.
flowchart LR Z["Zotero 서재"] -->|"Better BibTeX"| P["CMDS Zotero"] P --> N["문헌 노트"] P -->|"citekey 인덱스"| M["원고의 citekey 인용"] M -->|"Word kit"| W["Word 문서"] W -->|"Zotero 탭 Refresh"| Z %% @key: P, M
이 설명서를 읽는 길
| 지금 하려는 일 | 이 순서로 읽기 |
|---|---|
| 처음 설치한다 | 시작하기 → Zotero 쪽 준비 |
| 논문을 읽고 정리한다 | 핵심 개념 → 읽기와 문헌 노트 |
| 원고를 쓰고 Word로 넘긴다 | 인용 쓰기 → 참고문헌과 Word |
| 볼트가 여러 개다 | 여러 볼트 연결 |
| 강의나 스터디에서 따라 한다 | 실습 |
| 어떤 명령, 어떤 설정이 있는지 찾는다 | 명령 전체, 설정 전체, 또는 ⌘K |
먼저 나오는 질문
Obsidian의 pandoc 플러그인이 필요한가요? 아닙니다. CMDS Zotero는 다른 Obsidian 플러그인에 기대지 않습니다. Word로 넘길 때 필요한 것은 Obsidian 플러그인이 아니라 컴퓨터에 설치하는 pandoc 프로그램 하나입니다. 오히려 citekey 자동완성이 있는 Pandoc Reference List 같은 플러그인은 [@ 입력을 먼저 가져갈 수 있어 그 기능을 끄는 편이 좋습니다. 문제 해결
볼트 여러 개를 연결할 수 있나요? 됩니다. 설정의 Peer vaults에 한 줄에 하나씩 볼트 이름 | 절대 경로를 적으면, 같은 Zotero 항목을 다룬 다른 볼트의 노트를 찾아 엽니다. 다른 볼트는 읽기만 합니다. 여러 볼트 연결
Zotero 데이터가 바뀌나요? 바뀌지 않습니다. 플러그인은 Better BibTeX의 로컬 창구로 읽기만 하고, citekey, 컬렉션, 태그, 첨부를 건드리지 않습니다. 설계 원칙
모바일에서 되나요? 안 됩니다. Zotero와 Better BibTeX가 같은 컴퓨터에서 실행 중이어야 하므로 데스크톱 전용입니다.
0.6.6에서 달라진 것
2026-10-29에 공개한 0.6.6은 원고를 Word로 넘기는 길을 완성했습니다.
- Export Word kit with live Zotero citations for current note: 원고의 citekey 인용이 Word에서 살아 있는 Zotero 인용이 됩니다. Word의 Zotero 탭에서 Refresh 한 번이면 참고문헌까지 채워지고, 그다음부터 스타일 변경과 인용 추가는 Word에서 합니다.
- 내보낸 문서에 볼트의 메타데이터(태그, 설명, 로컬 경로)가 문서 속성으로 따라가지 않습니다.
- 세 가지 선택 설정, 모두 기본 꺼짐: 볼트 밖에 내보내기, 내보낸 뒤 pandoc 실행과 docx 열기, Hookmark로 docx와 원고 연결.
- Diagnose setup이
[@자동완성을 가로채는 다른 플러그인을 찾아 알려 줍니다.
전체 변경은 변경 기록에 있습니다.
릴리스: https://github.com/johnfkoo951/cmds-zotero/releases/tag/0.6.6