# `PtcRunner.SiteGuides.MarkdownHTML`
[🔗](https://github.com/andreasronge/ptc_runner/blob/main/dev/ptc_runner/site_guides/markdown_html.ex#L1)

Renders the bounded Markdown subset the guides use into HTML for the
static site.

The renderer is deliberately fail-closed: an element, attribute, parser
warning, or link shape it does not recognise raises instead of publishing
something silently wrong. Extend the whitelists when a guide legitimately
needs more Markdown.

# `rendered`

```elixir
@type rendered() :: %{title: String.t(), description: String.t(), html: String.t()}
```

# `render!`

```elixir
@spec render!(String.t(), String.t(), (String.t() -&gt; String.t())) :: rendered()
```

Renders one guide's Markdown.

`source` labels errors. `rewrite_link` receives every `href` exactly as
written in the Markdown and returns the href to publish; it should raise
on a target it cannot account for.

---

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