# `HtmlToMarkdown.ProcessingWarning`

A non-fatal diagnostic produced during HTML conversion.

Warnings indicate that conversion completed but some content may have been handled
differently than expected — for example, an image that could not be extracted, a truncated
input, or malformed HTML that was repaired with best-effort parsing.

Conversion always succeeds (returns `ConversionResult`) even when warnings are
present. Callers should inspect `warnings` and decide how to
handle them based on their tolerance for partial results:

- **Logging pipelines**: emit each warning at `WARN` level and continue.
- **Strict pipelines**: treat any warning as a hard error by checking
  `result.warnings.is_empty()` before using the output.

See [`WarningKind`] for the full taxonomy of warning categories.

# `t`

```elixir
@type t() :: %HtmlToMarkdown.ProcessingWarning{
  kind: String.t() | nil,
  message: String.t() | nil
}
```

A non-fatal diagnostic produced during HTML conversion.

---

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