도구별 실전 가이드 · 공식 정보 확인 2026-08-20

mdflux MIT 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Desktop · 페이지 갱신: · 운영·편집 기준

스캔 PDF와 폴더 묶음을 오프라인 OCR로 읽어 정돈된 Markdown으로 변환하는 스캔 문서를 AI용 Markdown으로 바꾸는 로컬 데스크톱 앱입니다.

스캔 PDF와 폴더 묶음을 오프라인 OCR로 읽어 정돈된 Markdown으로 변환하는 스캔 문서를 AI용 Markdown으로 바꾸는 로컬 데스크톱 앱입니다. mdflux의 첫 실전 과제는 “스캔한 회의 자료 폴더를 제목·표가 보존된 Markdown으로 일괄 변환하기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “기울어진 페이지와 표가 섞인 스캔 PDF 다섯 개” 같은 입력으로 mdflux의 핵심 기능을 시험하려는 사람
  • 페이지별 제목 계층·표의 행열·본문 순서가 원본과 대응하는지 기준으로 mdflux 결과를 직접 검수할 수 있는 경우
  • Desktop 환경에서 MIT 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • 스캔 문서를 AI용 Markdown으로 바꾸는 로컬 데스크톱 앱 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 저화질 스캔의 숫자와 표 셀이 잘못 인식돼 RAG가 틀린 사실을 검색하는 문제.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

스캔 폴더를 변환 대기열로 묶는다

기울기와 표가 섞인 PDF 다섯 개가 로컬 일괄 작업에 들어간다.

참고 시작점: 이 스캔 PDF 다섯 개를 원 파일별 Markdown으로 변환하고 페이지 경계를 표시해 줘.

  1. mdflux desktop app에 PDF 폴더 사본을 batch로 추가한다.
  2. local-first와 offline 처리가 활성화됐는지 네트워크 연결 없이 확인한다.
  3. 기울어진 페이지와 표 포함 페이지를 대표 검수 표본으로 표시한다.

OCR 결과를 문서 구조로 만든다

제목 계층과 표가 살아 있는 AI-ready Markdown이 생긴다.

참고 시작점: 제목 수준, 본문 읽기 순서, 표 행열을 보존한 깨끗한 Markdown으로 바꿔 줘.

  1. OCR과 pdf-to-markdown 변환을 다섯 파일에 실행한다.
  2. 반복 머리글과 페이지 번호를 본문에서 분리한다.
  3. 표 셀이 깨진 페이지는 자동 수정하지 않고 원 PDF 쪽과 함께 표시한다.

RAG 투입 전 숫자를 감사한다

검색에 넣어도 되는 Markdown과 재검수 문서가 구분된다.

참고 시작점: 각 문서의 제목 계층과 표 숫자를 원 PDF와 대조해 오류 목록을 만들어 줘.

  1. 첫·중간·마지막 페이지의 본문 순서를 원 스캔과 비교한다.
  2. 표의 합계·날짜·행열을 직접 대조해 잘못된 숫자를 고친다.
  3. 검수 완료 파일만 RAG 폴더로 옮기고 원본 페이지 링크를 유지한다.

무료 조건과 주의점

MIT 오픈소스 소프트웨어로 로컬 실행 횟수 제한 없음. 모델 다운로드와 GPU·전기 비용은 사용자 부담

MIT 오픈소스 소프트웨어로 로컬 실행 횟수 제한 없음. 모델 다운로드와 GPU·전기 비용은 사용자 부담

MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

저화질 스캔의 숫자와 표 셀이 잘못 인식돼 RAG가 틀린 사실을 검색하는 문제.

직접 대안과 비교

  • paddleocr-local — PDF·Office 문서를 로컬 OCR 모델로 Markdown 변환하고 모델별 결과를 비교하므로, 스캔 PDF 폴더의 제목·표 보존 과제를 WebUI나 CLI로 대체한다.

공식 근거와 확인일

mdflux 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보스캔 PDF와 폴더 묶음을 오프라인 OCR로 읽어 정돈된 Markdown으로 변환하는 스캔 문서를 AI용 Markdown으로 바꾸는 로컬 데스크톱 앱입니다.mdflux 공식 사이트
무료 조건MIT 오픈소스 소프트웨어로 로컬 실행 횟수 제한 없음. 모델 다운로드와 GPU·전기 비용은 사용자 부담공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지스캔 PDF와 폴더 묶음을 오프라인 OCR로 읽어 정돈된 Markdown으로 변환하는 스캔 문서를 AI용 Markdown으로 바꾸는 로컬 데스크톱 앱입니다.공식 제품 페이지