# `Excessibility.TelemetryCapture.Formatter`
[🔗](https://github.com/lessthanseventy/excessibility/blob/v0.18.1/lib/telemetry_capture/formatter.ex#L1)

Formats telemetry timeline data for different output formats.

Supports:
- JSON (machine-readable)
- Markdown (human/AI-readable)
- Package (directory with multiple files)

# `format_analysis_results`

Formats analysis results as markdown.

Takes map of analyzer_name => %{findings: [...], stats: %{...}}
and produces formatted markdown sections.

## Options

- `:verbose` - Include detailed stats even when no issues found (default: false)

# `format_json`

Formats timeline as JSON.

Converts tuples to lists and structs to maps for JSON compatibility.
Removes Ecto `__meta__` fields from converted structs.

# `format_markdown`

Formats timeline as markdown report.

Includes:
- Summary header
- Timeline table
- Detailed change sections
- Optional full snapshots (if snapshots provided)

---

*Consult [api-reference.md](api-reference.md) for complete listing*