Principle:PrefectHQ Prefect Markdown Artifact Creation
| Metadata | |
|---|---|
| Source | Repo: Prefect |
| Source | Doc: Prefect Artifacts |
| Domains | Observability, Orchestration |
| Last Updated | 2026-02-09 00:00 GMT |
Overview
A pattern for creating rich, human-readable artifacts during pipeline execution that are displayed in the Prefect UI for observability.
Description
Markdown Artifact Creation produces structured, visual summaries of pipeline results that appear in the Prefect UI. Artifacts are created during flow or task execution and persist beyond the run, providing a durable record of what the pipeline produced. They support markdown formatting for tables, lists, headers, and links, making them ideal for:
- Analytics summaries
- Data quality reports
- Pipeline result dashboards
- Audit trails
Usage
Use markdown artifacts when a pipeline produces results that should be visible in the Prefect UI without querying downstream systems. Common use cases: analytics summaries after data processing, data quality check results, model evaluation metrics.
Theoretical Basis
Artifacts implement the Observer Pattern for pipeline outputs. Instead of logs (ephemeral, unstructured), artifacts provide structured, persistent, and visually rich records of pipeline outputs. They decouple result presentation from result computation.