Video Workflows¶
CLI workflow¶
- Install
mdengine[video]. - Run
md-video --helpto list flags. - Provide input (Video files) and output path.
- Inspect generated Markdown and sidecar assets.
API workflow¶
- Install
mdengine[video,api]. - Start uvicorn on
md_generator.media.videoAPI module (see Deployment). - Call sync endpoint for small payloads or job endpoint for large conversions.
- Poll job status and download artifact when complete.
Processing pipeline¶
flowchart TD
Start[Start] --> InputLoad[Load_input]
InputLoad --> Validate[Validate_options]
Validate --> Transform[Core_conversion]
Transform --> Render[Render_Markdown]
Render --> Package[Write_output_or_ZIP]
Package --> End[Complete]
Async job flow¶
Where job routes exist, background work uses in-process threads or domain job managers; results land in job workspace + download.