A minimal FastAPI Markdown viewer deployed with Docker Compose and Caddy
- Python 89.6%
- Dockerfile 10.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| app | ||
| content | ||
| tests | ||
| .dockerignore | ||
| .gitignore | ||
| Caddyfile | ||
| compose.yaml | ||
| Dockerfile | ||
| pyproject.toml | ||
| README.md | ||
| uv.lock | ||
Marklight
Marklight is a minimal web application that reads content/README.md, renders it as HTML with FastAPI, and serves it through Caddy with automatic HTTPS.
Run locally
uv sync --dev
uv run pytest -q
docker compose up -d --build
The production Compose deployment expects marklight.dev.nextdorf.de to resolve to the host. Caddy obtains and renews its TLS certificate automatically.
Update the page
Edit content/README.md, then redeploy:
git pull --ff-only
docker compose up -d --build
Endpoints
/— rendered Markdown/health— application health check