# Inner
> 返回短代码开始标签与结束标签之间的内容，适用于短代码调用包含结束标签的情况。
- 官方英文原文：https://gohugo.io/methods/shortcode/inner/
- 本页规范地址：https://hugozh.cn/methods/shortcode/inner/
- 最近更新：2026-10-02
- 最后提交：912b1d3 chore(site): 添加 static/CNAME（hugozh.cn），供 GitHub Pages 等平台绑定自定义域名
- 签名：SHORTCODE.Inner
- 返回类型：template.HTML
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译，如有出入以官方英文原文为准
---
这段内容：
```md {file="content/services.md"}
We design the **best** widgets in the world.
```
配上这个短代码：
```go-html-template {file="layouts/_shortcodes/card.html"}
{{ with .Get "title" }}
{{ . }}
{{ end }}
{{ .Inner | strings.TrimSpace }}
Product Design
We design the **best** widgets in the world.
```
> [!NOTE]
> 短代码开始标签与结束标签之间的内容可能带有开头和/或结尾换行符，具体取决于它在 Markdown 中的位置。请如上所示使用 [`strings.TrimSpace`][] 函数移除回车符和换行符。
> [!NOTE]
> 在上面的示例中，`Inner` 返回的值是 Markdown，但它被当作纯文本渲染了。要把 Markdown 渲染为 HTML，请使用下面任意一种做法。
## 使用 RenderString
让我们修改上面的示例，把 `Inner` 返回的值传给 `Page` 对象上的 [`RenderString`][] 方法：
```go-html-template {file="layouts/_shortcodes/card.html"}
{{ with .Get "title" }}
{{ . }}
{{ end }}
{{ .Inner | strings.TrimSpace | .Page.RenderString }}
Product design
We produce the best widgets in the world.
```
你也可以用 [`markdownify`][] 函数代替 `RenderString` 方法，但后者的灵活性更好。详见[说明][]。
## 另一种记法
除了用 `{{}}` 记法调用短代码，还可以使用 `{{%/* */%}}` 记法：
```md {file="content/services.md"}
We design the **best** widgets in the world.
```
使用 `{{%/* */%}}` 记法时，Hugo 会把整个短代码当作 Markdown 渲染，因此需要做如下修改。
首先，配置渲染器，允许在 Markdown 中使用原始 HTML：
```toml
[markup.goldmark.renderer]
unsafe = true
```
如果内容是_你_自己控制的，这个配置并不危险。更多内容请阅读 Hugo 的[安全模型][]。
其次，由于我们把整个短代码当作 Markdown 渲染，就必须遵守 [CommonMark][] 规范中关于[缩进][]和[原始 HTML 块][]的规则。
```go-html-template {file="layouts/_shortcodes/card.html"}
{{ with .Get "title" }}
{{ . }}
{{ end }}
{{ .Inner | strings.TrimSpace }}
{{ with .Get "title" }}
-
{{ . }}
+
{{ . }}
{{ end }}
- {{ .Inner | strings.TrimSpace | .Page.RenderString }}
+
+ {{ .Inner | strings.TrimSpace }}