A single Docker container that wraps Microsoft MarkItDown in a website: drag-and-drop, multi-file queue, local Tesseract fallback for scanned PDFs/images, and an updates panel.
The UI title is MarkItDown. This repository is pdftomd.
- Queue files and folders, then click Convert (nothing uploads until then).
- Converts PDF, Office, images, HTML, EPUB, ZIP (explodes one level), audio, and other local MarkItDown formats. No YouTube/URL fetching.
- Default save location is this device (Chrome/Edge folder picker, or per-file download). Toggle to write into the server output folder.
- If a PDF or image has almost no text, Tesseract (English) OCRs it on the box. No API keys.
- On every container start, the entrypoint
git pulls this repo’smain, thenpip installsrequirements.txt.
Paste this into the Unraid Compose plugin (or save it as docker-compose.yml). You do not need a local Dockerfile. It pulls ghcr.io/charlie-kilo13/pdftomd:latest.
On Unraid, change ./output to a share path if you want (for example /mnt/user/appdata/pdftomd/output).
services:
markitdown:
image: ghcr.io/charlie-kilo13/pdftomd:latest
ports:
- "6565:8080"
environment:
APP_REPO_URL: https://github.com/charlie-kilo13/pdftomd.git
APP_BRANCH: main
APP_DIR: /data/app
OUTPUT_DIR: /output
MAX_FILE_MB: "200"
MAX_FILES: "50"
JOB_TIMEOUT_SEC: "600"
volumes:
- app-data:/data
- /mnt/user/appdata/pdftomd/output:/output
restart: unless-stopped
volumes:
app-data:Then compose up (no --build). Open http://<unraid>:6565. First start clones main and installs Python deps — give it a few minutes.
The container listens on 8080 inside the network. Compose publishes 6565 on the host. To bind only to localhost, use "127.0.0.1:6565:8080".
If GitHub Container Registry still says the package is private the first time, open the package → Package settings → Change visibility → Public.
| What | How |
|---|---|
| This app | Restart the container, or Pull latest main in the UI. That git-pulls main and reloads. |
| Microsoft MarkItDown library | The badge compares the pinned version in requirements.txt to the latest GitHub release. Bump the pin on main, then pull/restart. |
| Runner image (Tesseract, ffmpeg, entrypoint) | docker compose pull && docker compose up -d after a Dockerfile change is published to GHCR. |
MAX_FILE_MB(default 200)MAX_FILES(default 50)JOB_TIMEOUT_SEC(default 600)- Two conversions at a time
app/— FastAPI app (jobs, convert, updates)static/— UIentrypoint.sh— clone/pullAPP_REPO_URL, venv, uvicorndocker-compose.yml— pull GHCR image, host6565→ container8080