Markdown versions of all docs pages are available by appending .md to any docs URL.
Render hooks
How this module changes the way ordinary Markdown renders, without you calling anything.
These are not shortcodes. They change how ordinary markdown renders across every page, by overriding Hugo/Hextra render hooks. You do not call them; they just change the default output.
| Hook | What changes | Reference |
|---|---|---|
Table render hook (render-table.html) | Caps per-cell column width only on wide reference tables (a 3+ column header is the signal, for example Key | Type | Default | Description). Two-column narrative tables render uncapped and fill the content width. See .table-capped in docs-theme-extras.css. Each body cell also gets a class by content: .cell-short (30 plain characters or fewer, wraps between words only, one line below 768px), .cell-prose (longer, with a space, 9rem minimum width at 768px and up), or .cell-list (a longer cell that holds a list, 8.5rem minimum). Style or test against these classes, not an inline white-space style. Use the table shortcode below to override this per table. | Hugo table hooks |
Link render hook (render-link.html) | Simplified so it works inside RenderString context (nested reuse shortcodes), where .PageInner/.RelPermalink would fail. Uses relURL for internal links instead of full page resolution, so a plain Markdown link is never rewritten for the page’s version. See resolving links for when that means you want the link-hextra shortcode instead. | Hugo link hooks |
Blockquote alert hook (render-blockquote-alert.html) | Same as Hextra’s GitHub-style alert hook (> [!NOTE]), except it also ships two custom alert types that need no consumer config — [!SOLO] (branded, solo icon) and [!SUCCESS] (green check, the GitHub-syntax counterpart to callout type="success") — and additionally accepts any custom types a consumer declares under site.Params.themeExtras.alertTypes. Unknown types still warn and fall back to the default style. | Hugo blockquote hooks |
Was this page helpful?