ibrahimqureshae/mdflux

MDFlux – 어떤 문서든 깨끗하고 AI 준비된 Markdown으로 변환

무엇인가요 – PDF, DOCX, PPTX, XLSX, EPUB, HTML, CSV, JSON, XML, TXT, MD, 이미지, 오디오 등 다양한 파일 형식을 정돈된 Markdown으로 변환하는 Windows 전용 포터블 데스크톱 앱입니다. 로컬에서 실행되며 스캔된 PDF 및 이미지에 OCR을 수행하고, 필요 시 규칙 기반 또는 로컬/API 기반 LLM을 사용한 정리 단계를 선택적으로 제공합니다.

AI / RAG에 왜 중요한가요 – LLM 파이프라인은 일반적으로 텍스트를 입력으로 처리합니다. 시각 모델에 원본 이미지 페이지를 제공하는 것은 비용이 매우 높습니다. 각 이미지가 큰 고정 토큰 예산을 소비하기 때문입니다. MDFlux는 실제 문자를 추출하고, 제목, 표, 목록과 같은 구조를 일반 Markdown으로 유지함으로써 토큰화 비용을 2~6배 낮춥니다. 이 도구는 추론 비용을 줄이고, 데이터를 클라우드에 업로드하지 않아도 되므로 개인정보 보호를 보장합니다.

주요 기능

기능	이점
로컬 우선 / 오프라인	클라우드나 API 키 필요 없음. 문서는 절대 당신의 기계를 떠나지 않습니다.
내장 OCR	스캔된 이미지 전용 PDF 및 사진 파일이 비어 있는 결과가 아니라 텍스트로 변환됩니다.
배치 변환	폴더를 드래그하여 모든 파일을 진척 상황, 취소, 파일별 진단 정보와 함께 일괄 변환할 수 있습니다.
정제된 Markdown 출력	제목, 표, 목록을 유지. 읽기 쉽고, grep 가능, diff 가능합니다.
선택적 정리	비활성화, 규칙 기반, 또는 AI 처리 (로컬 모델 또는 API: DeepSeek, OpenAI, Groq 등). Changes 탭에서 추가/삭제된 줄을 확인할 수 있습니다.
오디오 전사	MP3, WAV 등은 동일한 워크플로우 내에서 텍스트로 전사됩니다.
터미널 필요 없음	포터블 zip. 압축 해제 후 MDFlux.exe 실행만 하면 됩니다.
확장 가능한 기술 스택	Tauri 2 (Rust) 쉘, Svelte 5 UI, Microsoft MarkItDown, RapidOCR, pypdfium2를 사용하는 Python 사이드카.

일반적인 워크플로우

1. 드래그 – 파일이나 폴더를 앱에 드래그합니다.
2. 선택 – 정리 모드 선택 (비활성화 / 규칙 기반 / 로컬 AI / API).
3. 변환 – 앱은 미리보기, 원본 소스, 분할 뷰, Changes 뷰를 표시합니다. 결과를 .md로 저장합니다.

첫 실행 시 개인 Python 환경이 다운로드됩니다 (한 번만, 인터넷 필요). 이후 실행은 완전히 오프라인입니다.

누가 사용해야 할까요

• RAG / AI 개발자 – 어떤 LLM에도 저렴하고 구조화된 소스 문서를 제공.
• 연구자 – 논문, 보고서, 아카이브를 일괄로 검색 가능한 Markdown으로 변환.
• 개발자 – 버전 관리에 사용 가능한 diff 가능한 텍스트를 바이너리 형식에서 얻음.
• 작가 / 분석가 – 계약서, 프레젠테이션 등에서 깨끗한 텍스트 추출.
• 개인정보를 중시하는 사용자 – 업로드 없이 민감한 파일을 변환.

Microsoft MarkItDown과의 비교 MDFlux는 MarkItDown을 핵심 변환 엔진으로 사용하지만 다음과 같은 추가 기능을 제공합니다:

• 스캔된 PDF 및 이미지용 OCR
• 명령줄 없이 그래픽 데스크톱 UI
• 자동 환경 설정 및 종속성 건강 상태 체크
• 진척 상황 UI를 갖춘 배치 처리
• 정리 모드 (LLM 기반 포함) 및 Changes 차이 보기
• 오디오 전사 지원
• 기본적으로 완전한 오프라인 프라이버시

시작하기

1. Releases 페이지에서 최신 Windows zip을 다운로드합니다.
2. 압축을 해제하고 MDFlux.exe를 실행합니다 (현대 Windows에는 이미 WebView2 런타임이 포함되어 있음).
3. 첫 실행 시 앱이 자체 포함된 Python 환경을 생성합니다 (약 1분 소요될 수 있음).
4. 파일/폴더를 드래그하고, 정리 모드를 선택한 후 변환합니다.

로드맵 주요 사항

• Claude Code와 같은 에이전트가 MDFlux를 직접 호출할 수 있는 MCP 서버
• 헤드리스 파이프라인 및 CI용 CLI
• macOS 빌드 (arm64 및 Intel)
• SmartScreen 경고를 제거하기 위한 코드 서명
• 더 많은 OCR 언어 및 튜닝 프리셋

라이선스 – MIT (© 2026 ibrahimqureshae). 자유롭게 사용, 수정, 재배포 가능.

---

MDFlux는 LLM용 문서 인게스팅을 더 저렴하고 프라이버시를 보장하는 진정한 소프트웨어 프로젝트입니다.