简介
当将 Markdown 渲染为 HTML 时,渲染钩子会覆盖转换。每个渲染钩子都是一个模板,每个支持的元素类型都有一个模板
例如,考虑以下 Markdown
[Hugo](https://gohugo.com.cn)
![kitten](kitten.jpg)
如果没有链接或图像渲染钩子,上面的示例将渲染为
<p><a href="https://gohugo.com.cn">Hugo</a></p>
<p><img alt="kitten" src="kitten.jpg"></p>
通过创建链接和图像渲染钩子,您可以更改从 Markdown 到 HTML 的转换。例如
<p><a href="https://gohugo.com.cn" 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
本节的其余页面将介绍每种类型的渲染钩子,包括示例和每个模板接收到的上下文。