Merge commit '5be51ac3db225d5df501ed1fa1499c41d97dbf65'

This commit is contained in:
Bjørn Erik Pedersen
2025-04-10 13:04:51 +02:00
987 changed files with 12379 additions and 14083 deletions

View File

@@ -1,14 +1,9 @@
---
title: Introduction
description: An introduction to Hugo's render hooks.
categories: [render hooks]
categories: []
keywords: []
menu:
docs:
identifier: render-hooks-introduction
parent: render-hooks
weight: 20
weight: 20
weight: 10
---
When rendering Markdown to HTML, render hooks override the conversion. Each render hook is a template, with one template for each supported element type:
@@ -21,13 +16,10 @@ When rendering Markdown to HTML, render hooks override the conversion. Each rend
- [Passthrough elements](/render-hooks/passthrough)
- [Tables](/render-hooks/tables)
{{% note %}}
Hugo supports multiple [content formats] including Markdown, HTML, AsciiDoc, Emacs Org Mode, Pandoc, and reStructuredText.
The render hook capability is limited to Markdown. You cannot create render hooks for the other content formats.
[content formats]: /content-management/formats/
{{% /note %}}
> [!note]
> Hugo supports multiple [content formats] including Markdown, HTML, AsciiDoc, Emacs Org Mode, Pandoc, and reStructuredText.
>
> The render hook capability is limited to Markdown. You cannot create render hooks for the other content formats.
For example, consider this Markdown:
@@ -37,7 +29,7 @@ For example, consider this Markdown:
![kitten](kitten.jpg)
```
Without link or image render hooks, this example above is rendered to:
Without link or image render hooks, the example above is rendered to:
```html
<p><a href="https://gohugo.io">Hugo</a></p>
@@ -85,3 +77,5 @@ layouts/
```
The remaining pages in this section describe each type of render hook, including examples and the context received by each template.
[content formats]: /content-management/formats/