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パイプラインは通常、テキストを入力として扱います。視覚モデルに画像として生のページを入力すると、各画像が大きな固定トークン予算を消費するため、コストが高くなります。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環境を作成します（数分かかる場合あり）。
4. ファイル/フォルダをドロップ、クリーンアップモードを選択、変換。

ロードマップのハイライト

• Claude CodeなどのエージェントがMDFluxを直接呼び出せるMCPサーバー
• ヘッドレスパイプラインおよびCI用CLI
• macOSビルド（arm64およびIntel）
• SmartScreen警告を回避するコード署名
• さらに多くのOCR言語とチューニングプリセット

ライセンス – MIT（© 2026 ibrahimqureshae）。自由に使用、変更、再配布可能。

---

MDFluxは、LLM向けドキュメントインジェストをより安価かつプライベートにする本格的なソフトウェアプロジェクトです。