원문 캡처 · github.com
원문 캡처 · github.com

Mktero는 Zotero 7, 8, 9, 10용으로 재시작 없이 설치할 수 있는 확장 프로그램이다. Zotero PDF를 수식·표·그림·인용·주석이 포함된 마크다운으로 열고, 문서의 텍스트와 그림에서 원본 PDF의 해당 위치로 이동할 수 있다. 개발자는 현재 베타라고 밝히며, 기본 변환에서는 캐시에 없는 PDF 전체를 Mktero 서비스로 보낸다고 안내한다.

GitHub 저장소 · 다운로드 · 제품 페이지 · 문서

기본 변환을 쓰려면 Mktero 계정으로 로그인하면 된다. MinerU나 Mistral을 선택하면 PDF는 해당 서비스로 전송되고 Mktero에는 보내지 않는다. 선택형 AI 번역은 보호된 마크다운 묶음을 사용자가 설정한 제공업체로 보낸다. 민감한 문서를 처리하기 전에는 개인정보 및 데이터 처리 안내를 확인해야 한다.

읽기와 원문 이동

Mktero는 PDF의 OCR 결과를 연속된 학술 문서 형태로 재배치한다. 다단 편집 텍스트, 수식, 표, 그림, 목록, 코드 등을 읽을 수 있고, 출판사 머리글, 첫 페이지 저작권 고지, 반복되는 머리글·바닥글과 페이지 번호를 숨긴다. 페이지와 영역의 대응 관계를 유지해 텍스트·수식·표·그림에서 PDF 원문 위치로 이동할 수 있다. PDF에서 텍스트를 선택하면 대응 위치가 하나로 특정되는 경우 해당 마크다운 문단을 열 수 있다.

MinerU 변환 결과에서는 각주를 인용 문단 뒤에 표시하고, 문서 메타데이터·저자 약력·보도 요약은 접힌 구역에 넣어 첫 화면에 제목·저자·초록이 보이도록 한다. 로컬에서 PDF 텍스트 레이어를 읽어 페이지나 단 나눔 때문에 마침표에서 끊긴 문단을 이어 붙이기도 한다. 절 번호가 없는 논문의 제목은 유형에 따라 단계별로 정리하고, 조판된 PDF에서는 OCR이 이름이나 저자의 표기를 잘못 수정한 단어를 인쇄된 텍스트에 맞춰 복원한다.

목차나 그림·표 색인을 이용해 문서를 둘러보고, 인용·소속·그림·표를 미리 볼 수 있다. Cmd/Ctrl+F로 본문을 검색한다. 읽기 화면을 벗어나지 않고 디스플레이 수식의 LaTeX, 코드 블록 텍스트, 마크다운 또는 CSV 형식의 표를 복사할 수 있다. 복사 작업은 렌더링된 문서를 읽으며 캐시된 마크다운을 바꾸지 않는다. 키보드나 복사 기능으로 가져온 내용은 수식을 $…$와 $$ 형식의 TeX로 포함한 표준 마크다운이므로, Zotero 노트나 TeX 수식을 표시하는 마크다운 편집기에 붙여 넣을 수 있다.

페이지 좌표와 마크다운 범위, 레이아웃 근거가 일치할 때는 로컬 PDF에서 그림을 다시 구성한다. 복원은 백그라운드 작업자에서 실행하고 자리표시자를 해당 위치에서 교체하므로, 그림 처리가 늦어도 읽기를 막지 않는다.

주석·번역·자료 관리

Zotero PDF의 강조 표시와 밑줄을 마크다운에 표시하고, 주석을 만들거나 색을 바꾸고 댓글을 달거나 삭제할 수 있다. 선택한 구절을 Zotero 노트에 추가하거나 논문의 주석을 새 노트로 옮길 수 있으며, 노트에서는 구절에 포함된 수식도 수식으로 표시한다. OCR 결과는 그대로 두고 기존 문단·제목·GFM 표 셀의 인식 오류를 수정할 수 있다.

설정한 Vercel AI SDK 제공업체를 통해 논문 전체를 번역할 수 있다. 원문, 번역문, 원문과 번역문을 이어 읽는 이중 언어 보기 사이를 전환하고, 선택한 용어나 구절을 필요할 때 조회할 수 있다.

마크다운 참고문헌이 접근 가능한 Zotero 라이브러리에 이미 있는지 확인하고, 다른 라이브러리에서 참고문헌을 복사하거나 누락된 메타데이터를 가져올 수 있다. 선택적으로 공개 PDF도 첨부할 수 있다. 현재 Zotero 라이브러리에 있는 논문 간 직접 참고문헌 관계를 살펴보며, 식별자를 사용할 수 있으면 Semantic Scholar, OpenCitations, OpenAlex를 이용한다.

휴대용 Zotero 스냅샷을 저장하거나 수정한 마크다운과 추출한 그림을 로컬 폴더 또는 Obsidian 보관함으로 내보낼 수 있다. 이미 변환된 마크다운을 여러 건 묶어 Obsidian 보관함에 기록하는 기능도 선택할 수 있다. 현재 설정에 맞는 변환 결과를 이 컴퓨터에서 읽을 수 있는 캐시에 보유한 경우 Zotero 항목 목록에 마크다운 열이 표시된다. PDF가 대기열에 있거나 변환 중이면 해당 열에는 현재 세션에서만 보이는 회전 표시가 나타난다. 준비 완료 표시는 Zotero 프로필에 저장되며 항목을 수정하거나 동기화하지 않는다.

인터페이스는 Zotero의 영어 또는 중국어 간체 표시 언어를 따른다. 그 밖의 언어에서는 영어로 표시된다.

설치와 이용 조건

시작하려면 XPI를 설치하고 Zotero의 Settings -> Mktero에서 로그인한 뒤 PDF를 열어 리더 도구 모음의 Mktero 아이콘을 누른다.

필요한 조건은 다음과 같다.

  • Zotero 데스크톱 7.0부터 10.0.*까지 지원한다.
  • PDF 첨부 파일은 내려받아 로컬 파일로 사용할 수 있어야 한다.
  • 기본 호스팅 변환에는 Mktero 계정이 필요하다. 이 방식은 MinerU 또는 Mistral 키를 요구하지 않는다.
  • 대체 변환기로 MinerU 클라우드, 자체 호스팅 MinerU 4.0 서비스 또는 Mistral을 선택할 수 있다. MinerU 클라우드와 Mistral에는 사용자의 API 키가 필요하며, 로컬 MinerU 키는 선택 사항이다.
  • Mktero 서비스 또는 선택한 변환기에 접속할 네트워크가 필요하다.

파일 크기·페이지 수·사용량 한도·서비스 이용 가능 여부는 선택한 변환기에 따라 다르다. MinerU 또는 Mistral을 선택할 때는 해당 서비스의 MinerU API 문서 또는 Mistral OCR 문서에서 현재 한도를 확인해야 한다. Mktero 호스팅 변환과 MinerU 클라우드는 PDF 한 건당 최대 200페이지를 받는다. 이 두 서비스로 PDF를 보내기 전 Mktero가 페이지 수를 로컬에서 세고, 200페이지를 넘으면 메시지를 표시하며 처리를 중단한다. 로컬 MinerU 서비스와 Mistral에는 이 검사를 적용하지 않는다.

설치 파일은 GitHub Releases에서 최신 mktero-<version>.xpi를 내려받는다. Zotero에서 Tools -> Plugins를 열고, 톱니바퀴 메뉴에서 Install Add-on From File...을 선택한 뒤 XPI 파일을 골라 안내에 따른다. 정식 GitHub 릴리스는 Zotero를 통해 자동 업데이트되지만 초안과 사전 릴리스는 자동 업데이트 대상으로 제공되지 않는다.

설치 후 Settings -> Mktero를 열어 설정한다. 기본 변환기는 Mktero이므로 해당 화면에서 로그인하거나 계정을 등록한다. PDF를 Mktero 서비스에 보내지 않으려면 MinerU 또는 Mistral을 선택하고 그 서비스의 API 키를 입력한다. AI 기능과 읽기 옵션은 선택 사항이며, 각 AI 제공업체의 모델·키·관련 설정은 각각 별도로 관리한다. 자격 증명은 현재 Zotero 프로필의 암호화되지 않은 일반 설정값으로 저장된다. 설정 전체는 구성 안내, 데이터 전송과 저장 방식은 개인정보 및 데이터 처리 안내에서 확인할 수 있다.

PDF 열기와 일괄 준비

기존 PDF나 라이브러리 항목에서 시작할 수 있다. Zotero에서 PDF를 열고 리더 도구 모음의 Mktero 아이콘을 누르거나, PDF 또는 라이브러리 항목을 마우스 오른쪽 버튼으로 눌러 Read as Markdown with Mktero를 선택한다. 여러 항목을 선택한 뒤 Prepare selected Markdown을 누르면 각 항목마다 탭을 열지 않고 대기열에 추가한다. 컬렉션을 마우스 오른쪽 버튼으로 눌러 Prepare collection Markdown을 선택하면 하위 컬렉션이 아니라 해당 컬렉션 자체의 PDF만 준비한다. 단일 항목에는 Read as Markdown with Mktero를 사용한다.

임시 Mktero 탭에서 업로드·변환·다운로드 진행 상황을 확인한다. 유효한 캐시 항목이 있으면 원격 변환을 건너뛴다. 일괄 작업은 Zotero 진행 창에 표시되며, 창을 최소화해도 준비 작업은 계속된다. 문서에서는 목차, 검색, 인용, 그림·표 미리 보기, 원문 연결, 주석 구역, 노트 열을 이용해 이동한다.

Mktero 탭은 현재 세션에서만 유지되며 Zotero를 다시 시작하면 복원되지 않는다. 탭을 닫아도 진행 중인 변환은 취소되지 않고 백그라운드에서 계속되며 준비 창에 표시된다. 확장 프로그램을 종료하면 진행 중인 변환 및 번역 요청이 취소된다. 일괄 작업에서 캐시되지 않은 PDF는 단일 변환과 같은 방식으로 전송된다. 같은 PDF와 변환 프로필을 다시 열면 마지막으로 읽던 문단을 복원한다.

개인정보와 저장 방식

캐시가 없는 PDF는 기본 변환에서 Mktero 서비스로 전송된다. MinerU 클라우드, 로컬 MinerU 서비스 또는 Mistral을 선택하면 PDF 전체는 그 서비스로 전송되고 Mktero에는 전송되지 않는다.

자격 증명, 캐시된 마크다운과 그림, PDF 사본을 포함하지 않은 저장 MinerU 결과, 수정 내용, 번역문, 읽기 위치, 아직 PDF에 반영되지 않은 로컬 강조 표시, 여러 페이지에 걸친 강조 표시를 연결하는 Zotero 주석 키는 현재 Zotero 프로필에 암호화되지 않은 상태로 저장된다. Mktero는 이 데이터를 동기화하지 않는다.

기본 변환에 로그인할 때 이메일과 비밀번호가 전송되며, 계정을 등록하면 인증 코드도 이메일로 전송된다. 액세스 토큰과 갱신 토큰은 같은 프로필에 저장된다. 계정 패널을 열어 둔 동안 확장 프로그램은 이 토큰을 사용해 선택한 서비스에 프로필과 변환 활동 건수를 요청하고, 이를 계정 카드의 수치로 보여 준다.

확장 프로그램은 로그인할 때와 토큰을 갱신할 때 자체 버전을 Mktero 서비스에 보고한다. 이를 통해 서비스 운영자는 어떤 빌드가 계속 사용되는지 확인할 수 있다. 이 보고에는 기기 지문, 하드웨어·운영체제 정보, IP에서 파생된 식별자가 포함되지 않는다. 제3자 분석 도구를 실행하지 않으며, 사용자가 설정한 변환기나 제공업체로 향하는 요청에 버전 보고를 붙이지 않는다. 이 정보는 계정 프로필에도 포함되지 않는다.

참고문헌·인용·번역 요청은 범위가 제한되고 로컬 우선으로 처리된다. 로그에는 API 토큰, 사전 서명 URL, PDF 바이트 또는 인증된 응답이 들어가지 않는다. 전체 데이터 표는 개인정보 및 데이터 처리 안내에 있다.

문서와 개발

프로젝트 문서에는 구성 안내, 읽기·주석 작업 흐름, 그림 처리 파이프라인, 개인정보 및 데이터 처리, 제한 사항, 개발 안내가 있다. 작업 흐름 문서는 수정·주석·Zotero 노트·AI 번역·인용·참고문헌·스냅샷·내보내기를 다룬다. 제한 사항 문서는 지원 PDF, 탐색 기능과 리소스 한도를 설명한다.

개발에는 .node-version에 지정된 Node.js 버전을 사용한다. 현재 버전은 24.15.0이며 Node.js 25는 지원되는 의존성 범위 밖이다. 원문에 제시된 확인·테스트·빌드 명령은 다음과 같다.

text
npm ci
npm run check
npm test
npm run build

그림 코퍼스 회귀 테스트는 개발 안내를 참고한다. 기여를 위한 풀 리퀘스트를 받으며, 실행 동작을 바꾸는 변경에는 위 전체 확인 명령을 실행하고 영향을 받는 동작의 테스트를 포함해야 한다.

사용 방법 질문은 커뮤니티 안내를 이용한다. 아이디어·읽기 작업 흐름·베타 의견은 GitHub Discussions에, 재현 가능한 버그는 GitHub Issues에 올릴 수 있다. 문제 보고는 Help > Report a Mktero Problem, 변환 실패 화면의 Report a problem 버튼 또는 Mktero 탭의 문서 작업 메뉴에서 할 수 있다. 이 기능은 정리된 진단 파일을 이 컴퓨터에 복사하거나 저장하며 업로드하지 않는다. 진단 파일을 이슈에 붙이거나 그룹에 보낼 수 있다. API 키, PDF 내용, 자격 증명이 든 로그를 QQ 그룹·WeChat·Discord·이슈·풀 리퀘스트에 올리지 말아야 한다.

사용 질문은 QQ 그룹, WeChat 또는 Discord에서 할 수 있다. QQ 그룹은 코드를 스캔하거나 QQ에서 616518076을 검색해 찾는다. 비공개 PDF와 그 밖의 민감한 정보도 커뮤니티와 로그에 공유하지 않아야 한다.

라이선스는 MIT이며 저작권 표기는 © 2026 Tony다.