MarkItDown GUI 🦄

A simple, modern, and minimalist CustomTkinter GUI wrapper for Microsoft's MarkItDown tool.

It allows you to easily convert documents (such as PDF, PowerPoint, Word, Excel, HTML, Text) to Markdown format via a clean graphical user interface.

Features

• File Selection: Choose multiple files (PDF, PPTX, DOCX, TXT, HTML, XLSX ) to convert.
• Output Folder Selection: Set a default output folder for converted Markdown files.
• Theme Selection: Toggle between Light and Dark themes.
• Conversion History View: Shows currently queued files and tracks success/failure.

Requirements

• Python 3.10+
• Dependencies listed in pyproject.toml (CustomTkinter and Microsoft's MarkItDown with PDF/Office extras).

Installation

1. Clone or download this repository.
2. Install the required dependencies:

   pip install -e .

   or

   pip install customtkinter "markitdown[pdf,pptx,docx,xlsx,xls]"

Usage

Run the GUI app using Python:

python main.py

Building the App

You can build a standalone desktop executable/app bundle using the provided build script:

chmod +x wrapApp.sh
./wrapApp.sh

This script uses PyInstaller to bundle the application. Ensure you have pyinstaller installed (pip install pyinstaller) before running the script.

While the wrapApp.sh and MarkItDownGUI.spec files are currently configured for macOS, but you can easily adapt them for Linux or Windows.

Credits

Powered by Microsoft MarkItDown.