Skip to content
charlie-kilo13Public

About

Self-hosted MarkItDown web UI: drag-and-drop conversion in a single Docker container

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MarkItDown (self-hosted)

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.

What it does

  • 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’s main, then pip installs requirements.txt.

Run (Unraid Compose, or any Docker host)

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.

Updates

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.

Limits (env-overridable)

  • MAX_FILE_MB (default 200)
  • MAX_FILES (default 50)
  • JOB_TIMEOUT_SEC (default 600)
  • Two conversions at a time

Layout

  • app/ — FastAPI app (jobs, convert, updates)
  • static/ — UI
  • entrypoint.sh — clone/pull APP_REPO_URL, venv, uvicorn
  • docker-compose.yml — pull GHCR image, host 6565 → container 8080

About

Self-hosted MarkItDown web UI: drag-and-drop conversion in a single Docker container

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages