Skip to content

Content extras

Stability

Classifications for this surface are recorded in STABILITY.md. Package maturity (Beta/Alpha) is separate from API level (beta / experimental / internal / deferred).

Status: Shipped in 0.6.0

Optional content helpers live in hedron.content (lazy imports; missing extras raise diagnostics with exact install commands).

Markdown

pip install "hedron[markdown]>=0.20.0,<0.21"

from hedron import Markdown

Markdown("# Hello\n\nSupports **fenced code** and tables.")

Rendered Markdown is sanitized through TrustedHtml.nh3 before html.raw. Install hedron[sanitize] (or rely on the markdown extra's dependency chain) so nh3 is available.

highlight_code

pip install "hedron[code]>=0.20.0,<0.21"

from hedron import highlight_code
from hedron_core.html import html

trusted = highlight_code("print('hi')", lexer="python")
node = html.div(html.raw(trusted), class_="hedron-code")

process_image

pip install "hedron[images]>=0.20.0,<0.21"

from hedron import process_image

# Returns processed bytes / metadata under Pillow; see remediation if Pillow is missing.
process_image(path_or_bytes, max_width=1200)

validate_email_address

pip install "hedron[email]>=0.20.0,<0.21"

from hedron import validate_email_address

validate_email_address("user@example.com")  # normalized address or raises

Install remediations

API Extra
Markdown pip install "hedron[markdown]>=0.20.0,<0.21"
highlight_code pip install "hedron[code]>=0.20.0,<0.21"
process_image pip install "hedron[images]>=0.20.0,<0.21"
validate_email_address pip install "hedron[email]>=0.20.0,<0.21"
TrustedHtml.nh3 pip install "hedron[sanitize]>=0.20.0,<0.21"

See also Security types and Charts and HTMX.