ibrahimqureshae/mdflux

MDFlux – 將任何文件轉換為乾淨、AI 就緒的 Markdown

它是什麼 – 僅限 Windows 的便攜式桌面應用程式，可將大量檔案類型（PDF、DOCX、PPTX、XLSX、EPUB、HTML、CSV、JSON、XML、TXT、MD、影像、音訊等）轉換為整齊的 Markdown。它在本機執行，對掃描的 PDF 和影像執行 OCR，並可選擇性地執行清理步驟（基於規則或本地/API LLM），以提升輸出品質。

對 AI / RAG 為何重要 – LLM 流水線通常處理文字。將原始頁面以影像輸入視覺模型成本高昂，因為每張影像都會消耗大量且固定的 token 預算。MDFlux 提取實際字元並保留結構（標題、表格、清單）為純 Markdown，其 token 化成本低 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，Python 旁車使用 Microsoft MarkItDown、RapidOCR、pypdfium2。

典型工作流程

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 環境（可能需一分鐘）。
4. 拖曳檔案/資料夾，選擇清理模式，開始轉換。

路線圖亮點

• MCP 伺服器，使 Claude Code 等代理可直接呼叫 MDFlux
• 無頭流水線和 CI 用 CLI
• macOS 建構（arm64 與 Intel）
• 代碼簽名以消除 SmartScreen 警告
• 更多 OCR 語言和調校預設

授權 – MIT（© 2026 ibrahimqureshae）。可自由使用、修改和分發。

---

MDFlux 是一個真正的軟體專案，旨在讓 LLM 的文件攝取更便宜且更私密。