A lightweight Windows desktop application that wraps Microsoft's MarkItDown library with a clean drag-and-drop interface — convert any supported file to Markdown in one click.
- Drag & drop files directly onto the window
- Batch conversion — queue multiple files at once
- Custom output folder — pick any destination directory
- Conversion log — real-time green/red feedback per file
- No terminal needed — runs as a silent desktop shortcut
- Supports all formats that MarkItDown handles
| Category | Formats |
|---|---|
| Documents | .pdf, .docx, .xlsx, .xls, .pptx, .ppt |
| Web | .html, .htm |
| Data | .csv, .json, .xml |
| Plain text | .txt |
| Images | .jpg, .jpeg, .png, .gif, .bmp, .webp |
| Audio | .mp3, .wav |
| Archives | .zip |
- Python 3.9+
- Windows 10 / 11
# 1. Clone the repository
git clone https://github.com/Christopher-V36/markitdown-gui.git
cd markitdown-gui
# 2. Install dependencies
pip install -r requirements.txtpython markitdown-gui.pypythonw markitdown-gui.pyCreate a shortcut pointing to:
Target: C:\Path\To\Python\pythonw.exe "C:\Path\To\markitdown-gui\markitdown-gui.py"
Start in: C:\Path\To\markitdown-gui
- Drop files onto the drop zone, or click "o selecciona archivos" to browse
- Choose a destination folder with the
…button (defaults to Desktop) - Click Convertir — the converted
.mdfiles appear in your chosen folder - The log panel shows a ✓ for each success and ✗ with the error message for failures
| Library | Purpose |
|---|---|
| markitdown | File-to-Markdown conversion engine |
| tkinterdnd2 | Drag-and-drop support for Tkinter |
| tkinter | GUI framework (stdlib) |
MIT © Christopher-V36