도구별 실전 가이드 · 공식 정보 확인 2026-08-20
obsidian-marker MIT 오픈소스 조건과 시작 절차
작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Extension · 페이지 갱신: · 운영·편집 기준
Mistral OCR이나 자가 호스팅 Marker로 PDF의 수식·표·이미지를 Markdown에 보존하는 PDF를 풍부한 Markdown 노트로 바꾸는 Obsidian OCR 플러그인입니다.
Mistral OCR이나 자가 호스팅 Marker로 PDF의 수식·표·이미지를 Markdown에 보존하는 PDF를 풍부한 Markdown 노트로 바꾸는 Obsidian OCR 플러그인입니다. obsidian-marker의 첫 실전 과제는 “수식과 표가 있는 강의 PDF 한 편을 Obsidian 노트로 변환하기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “2단 편집·LaTeX 수식·표 두 개가 포함된 12쪽 PDF” 같은 입력으로 obsidian-marker의 핵심 기능을 시험하려는 사람
- 본문 읽기 순서와 수식 기호·표 행열·추출 이미지 링크가 원본과 맞는지 기준으로 obsidian-marker 결과를 직접 검수할 수 있는 경우
- Extension 환경에서 MIT 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- PDF를 풍부한 Markdown 노트로 바꾸는 Obsidian OCR 플러그인 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: Mistral OCR로 기밀 PDF가 전송되거나 복잡한 수식·표의 작은 오인식이 Markdown에서 눈에 띄지 않는 문제.
참고 시작점
팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.
PDF와 OCR 경로를 분류한다
12쪽 강의 PDF에 맞는 Mistral 또는 self-hosted 변환 경로가 정해진다.
참고 시작점: 이 PDF의 2단 본문, LaTeX 수식, 표, 이미지를 보존할 OCR 경로를 선택해 줘.
- Obsidian Marker에 강의 PDF 사본을 연결한다.
- 기밀도에 따라 Mistral AI OCR과 self-hosted variant 중 하나를 고른다.
- 2단 페이지·수식·표가 있는 대표 쪽을 검수 표본으로 표시한다.
Obsidian Markdown으로 변환한다
본문·수식·표·이미지 링크가 있는 한 노트가 생성된다.
참고 시작점: 읽기 순서를 지키고 수식은 LaTeX, 표는 행열 구조, 이미지는 링크로 변환해 줘.
- PDF-to-Markdown 변환을 12쪽 전체에 실행한다.
- 2단 본문이 왼쪽 열 뒤 오른쪽 열 순서로 이어지는지 확인한다.
- 추출 이미지 파일과 Markdown 링크가 같은 vault 경로에 있는지 본다.
작은 기호와 표 숫자를 원본에 맞춘다
수식·행열·이미지 링크가 검수된 Obsidian 노트가 남는다.
참고 시작점: 수식 기호와 표 숫자를 원 PDF의 해당 쪽에 대조해 차이를 표시해 줘.
- 대표 수식의 첨자·그리스 문자·등호를 원 PDF와 문자별로 비교한다.
- 표 두 개의 행열과 숫자 합계를 Markdown 결과에 맞춘다.
- Mistral 경로를 썼다면 PDF 전송·보관 정책을 기록하고 임시 파일을 정리한다.
무료 조건과 주의점
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 로컬 경로 외에 선택형 외부 AI 공급자 연결 지원
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 로컬 경로 외에 선택형 외부 AI 공급자 연결 지원
MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.
Mistral OCR로 기밀 PDF가 전송되거나 복잡한 수식·표의 작은 오인식이 Markdown에서 눈에 띄지 않는 문제.
직접 대안과 비교
- mdflux — 스캔 PDF를 로컬·오프라인 OCR로 제목·표가 있는 Markdown으로 변환하므로, LaTeX 수식 보존 요구가 낮은 강의 자료는 같은 입력·출력으로 처리한다.
공식 근거와 확인일
| 확인 항목 | 확인한 내용 | 공식 출처·확인일 |
|---|---|---|
| 제품 정보 | Mistral OCR이나 자가 호스팅 Marker로 PDF의 수식·표·이미지를 Markdown에 보존하는 PDF를 풍부한 Markdown 노트로 바꾸는 Obsidian OCR 플러그인입니다. | obsidian-marker 공식 사이트 |
| 무료 조건 | MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 로컬 경로 외에 선택형 외부 AI 공급자 연결 지원 | 공식 무료 정책·요금 안내 |
| 공식 코드 라이선스 | 오픈소스 코드의 사용·수정·재배포 조건 | 공식 코드 라이선스 |
| 공식 제품 페이지 | Mistral OCR이나 자가 호스팅 Marker로 PDF의 수식·표·이미지를 Markdown에 보존하는 PDF를 풍부한 Markdown 노트로 바꾸는 Obsidian OCR 플러그인입니다. | 공식 제품 페이지 |