# `HtmlToMarkdown.UrlEscapeStyle`

URL encoding strategy for link and image destinations.

Controls how special characters in URL destinations are handled when they
require escaping to produce valid Markdown.

The `Angle` variant (default) wraps the destination in angle brackets:
`[text](<url with spaces>)`. This is the CommonMark-specified escape hatch
but breaks when the URL itself contains `>`.

The `Percent` variant percent-encodes every character that is not an RFC 3986
unreserved character or `/`, producing a destination safe for all Markdown
parsers: `[text](url%20with%20spaces)`.

# `t`

```elixir
@type t() :: :angle | :percent
```

URL encoding strategy for link and image destinations.

# `angle`

```elixir
@spec angle() :: t()
```

Wrap destinations that contain spaces or newlines in angle brackets. Default.

# `percent`

```elixir
@spec percent() :: t()
```

Percent-encode all characters that are not RFC 3986 unreserved or `/`.

---

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