简介
将Markdown渲染成HTML时,渲染钩子会覆盖转换过程。每个渲染钩子都是一个模板,每个支持的元素类型都有一个模板:
例如,考虑以下Markdown:
[Hugo](https://gohugo.io)

如果没有链接或图像渲染钩子,上面的示例将渲染为:
<p><a href="https://gohugo.io">Hugo</a></p>
<p><img alt="kitten" src="kitten.jpg"></p>
通过创建链接和图像渲染钩子,您可以更改从Markdown到HTML的转换。例如:
<p><a href="https://gohugo.io" rel="external">Hugo</a></p>
<p><img alt="kitten" src="kitten.jpg" width="600" height="400"></p>
每个渲染钩子都是一个模板,每个支持的元素类型都有一个模板:
layouts/
└── _default/
└── _markup/
├── render-blockquote.html
├── render-codeblock.html
├── render-heading.html
├── render-image.html
├── render-link.html
├── render-passthrough.html
└── render-table.html
模板查找顺序允许您为每个页面 类型 、 种类 、语言和 输出格式 创建不同的渲染钩子。例如:
layouts/
├── _default/
│ └── _markup/
│ ├── render-link.html
│ └── render-link.rss.xml
├── books/
│ └── _markup/
│ ├── render-link.html
│ └── render-link.rss.xml
└── films/
└── _markup/
├── render-link.html
└── render-link.rss.xml
本节其余部分描述每种类型的渲染钩子,包括示例和每个模板接收到的上下文。