```
### 渲染顺序
调用短代码所用的写法决定它在 Markdown 渲染的哪个阶段执行：
1. 用 Markdown 写法调用的短代码在 Markdown 渲染器之前按文档顺序执行。
1. Markdown 渲染器运行。
1. 用标准写法调用的短代码在 Markdown 渲染器之后按文档顺序执行。
这意味着，文档中靠前但使用标准写法调用的短代码，仍然晚于靠后但使用 Markdown 写法调用的短代码执行。
在同一阶段内，同一嵌套层级的短代码按文档顺序自上而下执行。短代码嵌套时，Hugo 由内向外渲染：每个嵌套短代码都先于它的父级执行，父级收到的 `Inner` 内容是所有嵌套短代码渲染完成的输出。例如对于下面的调用：
```md {file="content/example.md"}
```
Hugo 的渲染顺序是 `inner-a`、`inner-b`、`outer`（把前两者的渲染结果作为 `.Inner` 接收），最后是 `standalone`。
### 关于模板的返回值
短代码模板不写返回语句，Hugo 把模板渲染出的内容当作该次调用的返回值，直接放在调用处。由于渲染 HTML 时使用的是 Go 的 `html/template` 包，模板里由数据计算出来的字符串默认会被转义，以免内容破坏页面结构或引入注入风险；模板中直接书写的标签属于静态文本，会原样输出。
因此，当一段由数据拼出的字符串需要作为 HTML 输出时，要显式把它标记为可信内容；只想把它作为纯文本显示时则保持默认的转义即可。编写模板时请把这个区别放在心上：如果转义结果中出现 `<` 之类的实体，通常说明该内容被当作文本处理了。
### 其他参考
想找更多思路，可以研究 Hugo 的内置短代码，其源码是很好的范例。
## 检测短代码是否被使用
`HasShortcode` 方法可以检查某个短代码是否在页面上被调用过。例如有一个自定义的 `audio` 短代码：
```md {file="content/example.md"}
```
可以在基础模板中用 `HasShortcode` 判断该页面是否用过 `audio`，从而有条件地加载 CSS：
```go-html-template {file="layouts/baseof.html"}
{{ if .HasShortcode "audio" }}
{{ end }}
```