# Technical Reference

## Main Modules

- `markdown_web.app`: FastAPI app, routes, and templates.
- `markdown_web.service`: extraction and publishing service functions.
- `markdown_web.jobs`: Redis-backed Telegraph job state.
- `markdown_web.assets`: uploaded image validation and storage.
- `markdown_web.transcription`: OpenAI-compatible file transcription provider.
- `markdown_web.bookmarklet`: browser capture helpers.
- `markdown_web.telegram`: best-effort Telegram notifications.

## Boundaries

The web app may orchestrate extraction, publishing, uploads, and notifications.
Reusable extraction and conversion logic belongs in `markdown-this`,
`md-to-telegraph`, or `md-to-epub`.