selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
pullmd logo

Self-host pullmd

v3.16.0

URL and file to Markdown conversion service for AI agents

ReleaseOpen SourceAGPL-3.0
Updated6 hours ago
LanguageJavaScript
Setup difficultyEasy
MobileResponsive
ThemeDark mode
Stars
508
Port
3000 (HTTP web interface and API)
Docker
aeternalabshq/pullmd
Install with Docker Compose
PullMD web interface showing light and dark themes

What is pullmd?

PullMD is a self-hosted tool that transforms web pages, documents, images, audio files, and YouTube videos into clean Markdown. It processes web content through several extraction methods including Cloudflare's native Markdown, Readability, Trafilatura, and headless Chromium for JavaScript-heavy sites. The service handles Reddit and Hacker News discussion threads with their comment trees, document formats like PDF and Office files via MarkItDown with optional OCR for table preservation, YouTube video transcripts with clickable timestamps, and images or audio through OpenAI-compatible vision and speech-to-text APIs. Four interfaces are provided: a progressive web app, a REST API, an MCP server compatible with AI coding assistants featuring OAuth 2.1 support, and a downloadable skill for command-line use. Deployment is handled through Docker Compose with optional sidecar containers. Authentication options include open access, single-admin, and multi-user modes with session cookies, API keys, and OAuth 2.1. The project is licensed under AGPL-3.0.

Should you self-host pullmd?

pullmd scores 54/100 on selfhost.directory (how scoring works) and ranks #1 of 1 in Document Conversion. It has 508 GitHub stars.

It shipped 21 stable releases in the past year. The latest, v3.16.0, came out on 25 October 2026. New versions land roughly every 4 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in JavaScript.

Features

  • Audio Transcription
  • Claude Code skill
  • File to Markdown conversion
  • Hacker News thread extraction
  • Image captioning
  • Live share links
  • MCP Server
  • PDF OCR
  • Progressive Web App
  • Query-scoped extraction
  • Reddit thread extraction
  • REST API
  • Site recipes
  • URL to Markdown conversion
  • YouTube transcript extraction

pullmd README

How to install pullmd

Install pullmd with Docker Compose

Environment variables
PORT, PUBLIC_URL, TRAFILATURA_URL, PLAYWRIGHT_URL, MARKITDOWN_URL, and many optional variables

Zero-config default, multi-arch images on Docker Hub and GHCR

pullmd releases & version history

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…